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INTRODUCTION 

Congratulations, on your purchase of one of the best computers in the 
world. You are now the proud owner of the COMMODORE 64. Com¬ 
modore is known as The Friendly Computer company, and part of 
being friendly is giving you easy to read, easy to use and easy to 
understand instruction manuals. The COMMODORE 64 USER'S GUIDE is 
designed to give you all the information you need to properly set up your 
equipment, get acquainted with operating the COMMODORE 64, and 
give you a simple, fun start at learning to make your own programs. 

For those of you who don't want to bother learning how to program, 
we've put all the information you need to use Commodore programs or 
other prepackaged programs and/or game cartridges (third party 
software) right up front. This means you don't have to hunt through the 
entire book to get started. 

Now let's look at some of the exciting features that are just waiting for 
you inside your COMMODORE 64. First, when it comes to graphics 
you've got the most advanced picture maker in the microcomputer in¬ 
dustry. We call it SPRITE GRAPHICS, and it allows you to design your 
own pictures in 4 different colors, just like the ones you see on arcade 
type video games. Not only that, the SPRITE EDITOR let's you animate as 
many as 8 different picture levels at one time. The SPRITE EDITOR will 
soon be available as a software program that you can load directly into 
your COMMODORE 64. You can move your creations anywhere on the 
screen, even pass one image in front of or behind another. Your COM¬ 
MODORE 64 even provides automatic collision detection which instructs 
the computer to take the action you want when the sprites hit each 
other. 

Next, the COMMODORE 64 has built-in music and sound effects that 
rival many well known music synthesizers. This part of your computer 
gives you 3 independent voices, each with a full 9 octave "piano-type" 
range. In addition you get 4 different waveforms (sawtooth, triangle, 
variable pulse, and noise), a programmable ADSR (attack, decay, sus¬ 
tain, release) envelope generator and a programmable high, low, and 
bandpass filter for the voices, and variable resonance and volume con¬ 
trols. If you want your music to play back with professional sound re- 
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production, the COMMODORE 64 allows you to connect your audio out¬ 
put to almost any high-quality amplification system. 

While we're on the subject of connecting the COMMODORE 64 to 
other pieces of equipment . . . your system can be expanded by adding 
accessories, known as peripherals, as your computing needs grow. 
Some of your options include items like a DATASSETTE* recorder or as 
many as 5, VIC 1541 disk drive storage units for the programs you make 
and/or play. If you already have a VIC 1540 disk drive your dealer can 
update it for use with the COMMODORE 64. You can add a VIC dot 
matrix printer to give you printed copies of your programs, letters, in¬ 
voices, etc. . . If you want to connect up with larger computers and their 
massive data bases then just plug in a VICMODEM cartridge, and get 
the services of hundreds of specialists and a variety of information net¬ 
works through your home or business telephone. Finally if you're one of 
those people interested in the wide variety of applications software 
available in CP/M V *, the COMMODORE 64 can be fitted with a plug-in 
Z-80 microprocessor. 

Just as important as all the available hardware is the fact that this 
USER'S GUIDE will help you develop your understanding of computers. 
It won't tell you everything there is to know about computers, but it will 
refer you to a wide variety of publications for more detailed information 
about the topics presented. Commodore wants you to really enjoy your 
new COMMODORE 64. And to have fun, remember: programming is 
not the kind of thing you can learn in a day. Be patient with yourself as 
you go through the USER'S GUIDE. But before you start, take a few 
minutes to fill out and mail in the owner/registration card that came with 
your computer. It will ensure that your COMMODORE 64 is properly 
registered with Commodore Headquarters and that you receive the most 
up-to-date information regarding future enhancements for your ma¬ 
chine. Welcome to a whole new world of fun!! 

NOTE: 

Many programs are under development while this manual is being 
produced. Please check with your local Commodore dealer and with 
Commodore User's Magazines and Clubs, which will keep you up to 
date on the wealth of applications programs being written for the 
Commodore 64, worldwide. 


^DATASSETTE is a registered trademark of Commodore Business Machines, Inc. 

CP/M is a registered trademark of Digital Research Inc. Specifications subject *c 
change. 
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UNPACKING AND CONNECTING THE 
COMMODORE 64 

The following step-by-step instructions show you how to connect the 
Commodore 64 to your television set, sound system, or monitor and 
make sure everything is working properly. 

Before attaching anything to the computer, check the contents of the 
Commodore 64 container. Besides this manual, you should find the fol¬ 
lowing items: 

1. Commodore 64 

2. Power supply (black box with an AC plug and supply cord) 

3. Video cable 

4. TV Switchbox (small silver box with short antenna leads). 

If any items are missing check back with your dealer immediately for 
a replacement. 

First, let's take a look at the arrangement of the various connections 
on the computer and how each functions. 


o 




SIDE PANEL CONNECTIONS 

1 . Power Socket. The free end of the cable from the power supply is 
attached here to supply power to the Commodore 64. 

2. Power Switch. Turns on power to the Commodore 64. 

3. Game Ports. Each game connector can accept a joystick or game 
controller paddle, while the lightpen can only be plugged into the 
game port closest to the front of your computer. 

REAR CONNECTIONS 

4 . Cartridge Slot. The rectangular slot to the left accepts program or 
game cartridges. 

5 . Channel Selector. Use this switch to select which TV channel the 
computer's picture will be displayed on. 

6 . TV Connector. This connector supplies both the picture and sound to 
your television set. 

7. Audio & Video Output. This connector supplies direct audio, which 
can be connected to a high quality sound system, and a "compos¬ 
ite" video signal, which can be fed into a television "monitor." 

8 . Serial Port. You can attach a printer or single disk drive directly to 
the Commodore 64 through this connector. 




:Ar?:i 


OhoC 


v . 


Cosse^e nn fr eH i aa c - D- 

~*jf*£*~ sc *o» rcprr sc 


Pvt KanciLS rTrs»«- 
SwC^ Z3 Ipn* • 0* 


INSTALiAT 


Ik 


CONNECTIONS ’C * Out ' 



Conrec* ic»— C'-”’ 3 *-' 


. Affocf’ owe enc z r T 
The 'ec- c* “*ie Zmrmmatl 
car>e cor dc met 
2. Cc~~-ec* *-*c z 

push it in. 

















ortnimubt UriANNtL 


SLOT 


lv HUL>IU/Viutu btK IAL CASSETTF IKFR 

SELECTOR CONNECTOR CONNECTOR PORT INTERFACE PORT 


9. Cassette Interface. A DATASSETTE recorder can be attached to the 

computer so you can save information entered for use at a later 
time. 

10. User Port. Various interface cartridges can be attached to the user 
port, such as the VICMODEM, or RS 232 communication cartridge. 


INSTALLATION 

CONNECTIONS TO YOUR TV 

Connect the computer to your TV as shown on page 4. 

1. Attach one end of the TV cable to the phono type TV signal jack at 

the rear of the Commodore 64. Just push it in. Either end of the 
cable can be used. 

2. Connect the other end of the cable to the antenna switchbox. Just 
push it in. 
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POWER 

SUPPLY 


3. If you have a VHF antenna, disconnect it from your TV set. 

4. Connect your VHF antenna cable to the screw terminals labeled "an¬ 
tenna input" on the switchbox. If your antenna cable is the round 
75-ohm coax type, use a 75-ohm to 300-ohm adapter (not supplied) 
to attach your antenna cable to the switchbox. 

5. Connect the twin lead output cable of the antenna switchbox to the 
VHF antenna terminals of your TV set. If your set is one of the newer 
types with a round 75-ohm VHF connector, you will need a 300-ohm 
to 75-ohm converter (not supplied) to connect the switchbox to the 
75-ohm VHF antenna input on the set. 

6 . Set the TV's VHF tuner to the channel number indicated on the com¬ 
puter's channel selector switch (channel 3 move the switch to the left, 
channel 4 move the switch to the right). If a strong local TV signal is 
present on one of these channels, select the other channel to avoid 
possible interference. 

8 . Plug the power supply cable into the power socket on the side of the 
Commodore 64. Just push it in. It is "keyed" to allow insertion in only 
one direction, so you can't connect the power cord the wrong way. 
The power supply converts household current into the form the com¬ 
puter uses. 
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YOUR 75 OHM 
COAX VHF ANTENNA 



The Commodore 64 is now correctly connected. No additional con¬ 
nections are required to use the computer with your TV. The antenna 
switchbox will connect the computer to the TV when the slide switch is in 
the computer" position. When the switch is in the "TV" position your set 
will operate normally. 













































ANTENNA 
(IF USED) 


OPTIONAL CONNECTIONS 

Since the Commodore 64 furnishes a channel of high fidelity sound, 
you may wish to play it through a quality amplifier to realize the best 
sound possible. In addition, the Commodore 64 also provides a stan¬ 
dard "composite" video signal, which can be fed into a television 
monitor. 

These options are made possible by the audio/video output jack on 
the rear panel of the Commodore 64. The easiest way to gain access to 
these signals is by using a standard 5-Pin DIN audio cable (not 
supplied). This cable connects directly to the audio/video connector on 
the computer. Two of the four pins on the opposite end of the cable 
contain the audio and video signals. Optionally, you can construct your 
own cable, using the pinouts shown in Appendix I as a guide. 


6 





















































Normally, the BLACK connector of the DIN cahU r 

P'»9 may b. connected ,h. AUXIUArT ", AUD '° 
Pl'fier, or the AUDIO IN connector of • X L ARY ln P ut of an am- 

such as a video cassette recorder ^ 1 "°^ " ^ 

C z “ ppii " ,he , *•" vimo ■*-. 

x r on - ^ r xr ior - **• 

of ,h. P plos?m°aVb'e “u.'.fhT"' “ di "» 

*. ^zs^z;'r don ’”•* ™ dto ***• ”9"o' 


>— 1 1 * 

Junn nnnnnnnnmf i 

audio/video 


OUTPUT 


4 



a, a VicTsTd^rt" 0 ’ “ » « >34, dish ddu. 

•3. - manuals » *"’’*■ *> 

Pmpo, procedure for co„„,c,„ g it to L cot pu “ r "" 


7 






































































A completed system might look like this. 



OPERATION 

USING THE COMMODORE 64 

1. Turn on the computer using the rocker switch on the right-side panel 
when you're looking at the computer from the front. 

2. After a few moments the following will be displayed on the TV 
screen: 


##*# COMMODORE 64 BASIC V2 #*#♦ 

64K RAM SVSTEM 38911 BASIC BYTES FREE* 


READY 


J CURSOR SIGNALS 
r COMMODORE 64 IS 
I WAITING FOR YOUR 
^INPUT. 
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3. If your TV has a manual fine tuning knob, adjust the TV until you get 
a clear picture. 

4. You may also want to adjust the color and tint controls on the TV for 
the best display. You can use the color adjustment procedure de¬ 
scribed later to get everything setup properly. When you first get a 
picture, the screen should appear mostly dark blue, with a light 
blue border and letters. 


If 


• you don't get the expected results, recheck the cables and connec¬ 
tions. The accompanying chart will help you isolate any probler 


sm. 


TROUBLESHOOTING CHART 


Symptom 

Cause 

Remedy 

Indicator Light 

not “On" 

Computer not 
“On" 

Make sure power 
switch is in “On" 
position 


Power cable 

Check power socket 


not plugged 

for loose or dis¬ 


in 

connected power 
cable. 


Power supply 

Check connection 


not plugged 

with wall outlet 


in 



Bad fuse in 

Take system to 


computer 

authorized dealer 
for replacement of 
fuse 


TV on wrong 

Check other 


channel 

channel for 
picture (3 or 4) 


Incorrect 

Computer hooks up to 


hookup 

VHF antenna terminals 


Video cable 

Check TV output 


not plugged 

cable connection 


in 



Computer set 

Set computer for 


for wrong 

same channel as TV 


channel 

(3 or 4) 

-—-- 

























Symptom 

Cause 

Remedy 

Random pattern 
on TV with 
cartridge in 
place 

Cartridge not 

properly 

inserted 

Reinsert 
cartridge after 
turning off power 

Picture without 

color 

Poorly tuned 

TV 

Retune TV 

Picture with 
poor color 

Bad color 
adjustment 
on TV 

Adjust color/ 
hue/brightness 
controls on TV 

Sound with 

excess 

background 

noise 

TV volume up 
high 

Adjust volume of 

TV 

Picture OK, 
but no sound 

TV volume too 

low 

Adjust volume of 

TV 


Aux. output 
not properly 
connected 

Connect sound 
jack to aux. input 
on amplifier and 
select aux. input 


TIP: The COMMODORE 64 was designed to be used by everyone. 

But we of Commodore recognize that computer users may, occasionally, run into 
difficulties. To help answer your questions and give you some fun programming 
ideas Commodore has created several publications to help you. You might also find 
that it's a good idea to join a Commodore Users Club to help you meet some other 
COMMODORE 64 owners who can help you gain knowledge and experience. 


CURSOR 

The flashing square under READY is called the cursor and indicates 
where what you type on the keyboard will be displayed on the screen. 
As you type, the cursor will move ahead one space, as the original 
cursor position is replaced with the character you typed. Try typing on 
the keyboard and watch as characters you type are displayed on the TV 
screen. 
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COLOR ADJUSTMENT 
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and then move down to the next line as long as the 
pressed. 


**** COMMODORE 64 BASIC V2 #.**# _ 

S4K RAM SVSTEM 38911 BASIC BVTES FREE 


READS’ 


is de- 


Now, holdGElwhHe depressing any of the other number keys. Each 
of them has a color marked on the front. Anything d.sp'ayed from th,s 
point will be in that color. F or examp |e< hold EES and theQ ey 

release both. Now hold the ' 

Watch the display. The bar is now in yellow! In a like manner you can 
change the bar to any of the other colors indicated on the number keys 

by holding QEI and fhe appropriate key. ..... 

Change the bar to a few more different colors and then adjust the 
color and tint controls on your TV so the display matches the colors you 

selected. 

The display should appear something like this: 



At this point everything is properly adjusted and working correctly, 
rhe follow" g chapters will introduce you to the BASIC 
,ver you can immediately start using some of the many prewr, ten ap¬ 
plications and games available for the Commodore 64 without knowmg 

anything about computer programming. 

Each of these packages contains detailed information.about how to 
use the program. It is suggested, though, that you read through the f. 
few chapters of this manual to become more fam.har with the bas,c 
operation of your new system. 
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CHAPTER 


getting started 

Keyboard 

Back to Normal 

Loading and Saving Programs 

PRINT and Calculations 

Precedence 

Combining Things 







KEYBOARD 


EDITING 


Now that you've got everything set up and adjusted, please take a 
few moments to familiarize yourself with the keyboard which is your 
most important means of communication with the Commodore 64. 

You will find the keyboard similar to a standard typewriter keyboard 
found in most areas. There are, however, a number of new keys which 
control specialized functions. What follows is a brief description of the 
various keys and how they function. The detailed operation of each key 
will be covered in later sections. 






The key signals the computer to look at the information that 

you typed and enters that information into memory. 


The m2) key works like that on a standard typewriter. Many keys 
are capable of displaying two letters or symbols and two graphic char¬ 
acters. In the "upper/lower case" mode the QQQ key gives you stan¬ 
dard upper case characters. In the "upper case/graphic" mode the 
QQQI key will display the graphic character on the right hand side of 
the front part of the key. 

In the case of special YELLOW function keys, the key will give 

you the function marked on the front of the key. 


No 




num ber 


matio r ' a r c _^a o 



MST/D& 


ikt mp 


ing 


of 




right automar 


A 

example, I 
perhaps you 
move back r 
just type in * 


■st Da 


5 5 *— 


CLR/HOME 


[ 222^3 30Si*; O'* 5 *~e C 

which is the uppe r e^-rc* 
screen and place ~ n e c_"c 


RESTORE 




normal state it was in 
some command. A o* 
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EDITING 


No one is perfect, and the Commodore 64 takes that into account. A 

number of echtmg keys let you correct typing mistakes and move infor- 
motion around on the screen. 


There °^° keyS mQrked GH (CuRSoR), one with up and down 
arrows H tt fljll ' the other wlth ,eft and right arrows mm You can 
use these keys to movethe cursor up and down or left and right. In the 

Z : l, 7 ' 7 S kW ,b, cursor down and 7 

mild 7 9 ' 00 feeV ° nd k ' yS "» ™~, to b. 

Wuro’7 e 7 P h "' The cur “ r key ‘ hare » ~r.« 

eature that keeps the cursor moving until you release the key. 


INST/DEL 


If you hit the 


INST/DEL® 


inn mpi , u- ^ thS CUrS ° r Wi " move back a s P°ce, eras¬ 

ing (DELeting) the previous character you typed. If you're in the middle 

of a line, the character to the left is deleted and the characters to the 
right automat ically mo ve together to close up the space. 

A EEIed UEH23 allows you to INSerT information on a line. For 
example, if you noticed a typing mistake in the beginning of a line — 

perhaps you left out part of a name—you could use the gffCTEB key to 
move back to the error and then hit " nm 

iust type in the missing letter. 


you could use the | 

<=CRSR=> 

INST/DEL 

| to insert < 

3 space 


CLR/HOME 


CLR/HOME 


Positions the cursor at the "HOME" position of the screen 
wh,ch ,s the upper left-hand corner. A shifted BUTOB will clear the 
screen and place the cursor in the home position. 


RESTORE 


operates as the name implies. It restores the computer to the 
normal state it was in before you changed things with a program or 
some command. A lot more will be said on this in later chapters 
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FUNCTION KEYS 
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RUM'STOP 


The four function keys on the right side of the keyboard can be "pro¬ 
grammed" to handle a variety of functions. They can be defined in 
many ways to handle repetitive tasks. 





CTRL 


TheOBn^Y' which stands for ConTRoL, allows you to set colors, and 
perform other specialized functions. You hold the U^Jkey down while 
depressing another designated key to get a control function. You had an 
opportunity to try the RTjQj key when you changed text colors to create 
different color bars during the setup procedure. 


RUN/STOP 


Normally, depressing the ke Y w ' 11 sto P the execution of a 

BASIC program. It signals the computer to STOP doing something. Using 





the | 
load 


prog-'c — 


□ COMMODORE KEY 
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The second functor r - me Q «« 
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BACK TO NORMAL 
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spaces . If we *vere *■ me -or— <3 * 
cursor would nave movec z-j~ _ 5- 
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the nasaa key in the shifted mode will allow you to automatically 
load a program from tape. 


COMMODORE KEY 


The Commodore key Q performs a number of functions. First it 
allows you to move between the text and graphic display modes 
When the computer is first turned on, it is in the Upper Case/Graphic 
mode that .s, everything you type is in upper case letters. As was men¬ 
tioned usmg the BUB key in this mode will display the graphic on the 
right side of the keys. 

If you hold down the Q key and 00 key, the display will change 
to upper and lower case. Now, if you hold down the 0 key and any 

other key with a graphic symbol, the graphic shown on the left side of 
the key will be displayed. 

To get b ack into the upper case/graphic mode hold down the 0 key 
and key again. 

The second function of the Q key is to allow you access to a second 
set of eight text colors. By holding down the Q key and any of the 
number keys, any text now typed will be in the alternate color available 

from the key you depressed. Chapter 5 lists the text colors available 
trom each key. 


BACK TO NORMAL 


Now that you've had a chance to look over the keyboard, let's explore 
some of the Commodore 64's many capabilities. 

If u°u 2J; aVe th e color b ars ^e screen from adjusting your TV 
e , o Kliilll °nd UHliBHJ • The screen should clear and the cursor 
will be positioned in the "home" spot (upper left-hand corner of the 
screen). 

Now simultaneously hold Q and the Q key. This sets the text color 
back to light blu e. The re is one more step needed to get everything back 
to normal. Hold BB1 and Q (Zero not Oh!). This sets the display mode 
twk to normal. If you remember, we turned REVERSE type on with the 
create the color bars (the color bars were actually reversed 
spaces). If we were in the normal text mode during the color test, the 
cursor would have moved, but just left blank spaces. 
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TIP: 


Now that you've done things the hard way, there is a simple way to reset the 
machine to the normal display. First press the key an d then press 

the ESEE3 key. must always be held down in order to use the 

ES3E9 key function. 

This will clear the screen and return everything to normal. If there is a program in 
the computer, it will be left untouched. This is a good sequence to remember, espe¬ 
cially if you do a lot of programming. 

If you wish to reset the machine as if it were turned off and then switched on 
again, type, SYS64759 and press . Be careful using this command! It wiil 

wipe out any program or information that is currently in the computer. 


LOADING AND SAVING PROGRAMS 

One of the most important features of the Commodore 64 is the ability 
to save and load programs to and from cassette tape or disk. 

This capability allows you to save the programs you write for use at a 
later time, or purchase prewritten programs to use with the Commodore 
64. 

Make sure that either the disk drive or datasette unit is attached 
properly. 

LOADING PREPACKAGED PROGRAMS 

For those of you interested in using only prepackaged programs 
available on cartridges, cassette, or disk here's all you have to do: 

1. CARTRIDGES: The Commodore 64 computer has a line of programs 
and games on cartridge. The programs offer a wide variety of business 
and personal applications and the games are just like real arcade 
games — not imitations. To load these games, first turn on your TV seT. 
Next turn OFF your Commodore 64. YOU MUST TURN OFF YOUR COM¬ 
MODORE 64 BEFORE INSERTING OR REMOVING CARTRIDGES OR YOU 
MAY DAMAGE THE CARTRIDGE AND/OR YOUR COMMODORE 64! 
Third insert the cartridge. Now turn your Commodore 64 on. Finally type 
the appropriate START key as is listed on the instruction sheet that comes 
with each game. 

2. CASSETTES: Use your DATASS ETTE recorder and the ordinary audio cas¬ 





settes that ca~e c 
the tape s compel . --... - 
Then, just type .C-C zcr 
TAPE, so yc. -escc — r. -re**; 
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first program or *ne tape 
After you press 



















senes that came as part of your prepackaged program Make su 
he tape ,s completely rewound to the beginning of the first s i 
hen ,ust type LOAD. The computer will answer whh PRESSY ON 
TAPE, so you respond by pressing play on your datasette machine A " 

nd Th C ° mPUter $Creen Wi " 90 bl °" k -til the prog am i 

:r, r r 


3. DISK: Using your disk drive, carefullv insert tk 

so that the Inkel + l , V the P re P r og rammed disk 

for a i n , jhe d,sk is facing up and is closest to you Look 

race) n • ° n $k (it mi9ht be C0Vered with ° h'ttle piece of 

side^ Onc y e 0 t U h r e e d'is S k ertin9 d e f" Pr ° Per ' y ** Wi " be the left 

on the lev m * °* e the protective gate by pushing down 

■M7«v Tjr ; i OAD / ,PR ° GB “ NAME", 8 „„d hi, ,8. 
wma key- The d„k will woke noise cod your screen will soyi 


SEARCHING FOR PROGRAM NAME 
LOADING 

READS’ 

■ 


When the READY comes on and the | is on, just type RUN and 
your prepackaged software is ready to use. 

LOADING PROGRAMS FROM TAPE 


Loading a program back from tape or disk is just 
rewind the tape back to the beginning and type: 


as simple. 


For tape, 


LORD "PROGRAM NAME* 




r "unit?, |ust type LO/ 

first program on t he tape will be loaded into memory. 

ter you press the computer will respond with: 
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PRESS PLRV ON TAPE 


After you depress the play key, the screen will blank, turning the 
border color of the screen as the computer searches for the program. 
When the program is found, the screen will display: 


FOUND PROGRAM NOME 


To actually LOAD the program, depress the Q key. To abandon the 
LOADing procedure, hit IJWIHBfl . If you hit the Commodore key, the 
screen will again turn the border color while the program is LOADed. 
After the LOADing procedure is completed, the screen will return to the 
normal state and the READY prompt will reappear. 


LOADING PROGRAMS FROM DISK 

Loading a program from disk follows the same format. Type: 






LORD "PROGRAM NAME",8 


The 8 is the code for the disk, so you're just letting the computer know 
that you want the program loaded from the disk. 


After you hit 
shows: 


RETURN 


the disk will start whirring 


and the display 


SEARCHING FOR PROGRAM NAME 
LOADING 

READV 

I 
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r~ a Wank turning the 
the program. 



3 


"r SC'rf" 


To abandon the 
'adore key, 
a- is LOADea. 

r urn to t+se 


* 
* 



NOTE: 

Wh en you load a new program into the computer's memory, any in- 
10 ns that were in the computer previously will be erased Make 
sure you save a program you're working on before loading a new one 
Once a program has been loaded, you can RUN it, LIST it, or make 
changes and re-save the new version. 


SAVING PROGRAMS ON TAPE 

After entering a program, if you wish to save 


it on tape, type: 


SftVE "PROGRAM NAME" 


"PROGRAM NAME" can be im t n ia u 

mm th» , ! „ p 16 c ^ aracters long. After you hit 

™ e computer will respond with: 


F RES- PLAV AND RECORD ON TAPE 





Press both the record and play keys on the datasette. The screen will 
blank, turning the color of the border. 

After the program is saved on tape, the READY prompt will reappear 
indicating that you can start working on another program or just turn 
off the computer for a while. 1 turn 

SAVING PROGRAMS ON DISK 

Saving a program on disk is even simpler. Type: 














The 8 is the code for the disk, so you're just letting the computer know 
you want the program saved to disk. 

After you press t * le wi ^ start to turn anc * f ^ e com P uter 

will respond with: 


SftVING "PROGRRM NAME” 

OK 

REftOV 



PRINT AND CALCULATIONS 

Now that you've gotten through a couple of the more difficult opera¬ 
tions you need in order to keep the programs you like, lets start making 
some programs for you to save. 

Try typing the following exactly as shown: 



If you make a typing mistake, use the ESEB key *° erase the char¬ 
acter immediately to the left of the cursor. You can delete as many 
characters as necessary. 

Let's see what went on in the example above. First, you instructed 
(commanded) the computer to PRINT whatever was inside the quote 
marks. By hitting B33B33I Y ou t0 ^ f ^ e computer to do what you in¬ 
structed and COMMODORE 64 was printed on the screen. 

When you use the PRINT statement in this form, whatever is enclosed 
in quotes is printed exactly as you typed it. 

If the computer responded with: 

?SYNTAX ERROR 

ask yourself if you made a mistake in typing, or forgot the quote marks. 
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W° mPUter iS PreCiSe ° nd 6XPeCtS inStructions be given in a specific 
But don't get worried; just remember to enter things as we present 

dcmT 64. 6X0 ° nd y ° U '" 96t al ° n9 9reQt With the Comm o- 

Remember you can't hurt the computer by typing on it, and the best 

Wa p y RINT* $ am fth IS f ° ^ different thin9s and see what happens. 

I : r 6 m ° St USefu ^ and Powerful commands in the BASIC 

naToo’hi? VOU “ n , d “ pl °'' i”“ »»y*W"3 yo3 Wish, includ- 

mg graphics and results of computations 

~ r.r pl d' 'si^°"r in ^ a " ,r "" scr "" b * d -" *» 

^ y Wlifiil’llill hey and type (b e a,re to use the T key for 

one, not a letter 'I 7 ): Y or 


PRINT 
24 —_ 



What you've discovered is that the Commodore 64 is a calculator in its 

In fact 0 ™ 6 reS | U f ° f ^ WQS calculated and Panted automatically. 

fact, you can also perform subtraction, multiplication, division ex¬ 
ponentiation, and advanced math functions such as calculating square 

mor ih 1 y ° U ^ n0t limit6d f ° ° Sin9lS Calculati °n °n a line, but 
more on that later. 

Note that in the above form, PRINT behaved differently from the first 
example^ In this case, a value or result of a calculation is printed, rather than 
exact message you entered because the quote marks were omitted. 

ADDITION 

The plus sign (+) signals addition: we instructed the computer to print 
the result of 12 added to 12. Other arithmetic operations take a similar 
form to addition. Remember to always hit gBHIrJM after typing PRINT 
and the calculation. 
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SUBTRACTION 


EXPONENTLADC N 



To subtract, use the conventional minus ( ) sign. Type: 



MULTIPLICATION 


If you wanted to multiply 12 times 12, use the asterisk (*) to represent 
multiplication. You would type: 






PRINT 12 f 5 

248832 


'5 i SC—* 


PRINT 12 • 12 • 12 « 

248332 


TIP: 


~z BASIC zz'—" —ares rr «.*». 
c-e Ac z>z zr * I r*e cra-seaT**-:: 
obbre-.’ir-o'S *:* eo: ~ zriz » 


DIVISION 

Division uses the familiar For example, to divide 144 by 12, type: 



24 






h e : as* exc —c 


ioy c-e 


types. 

You 



























►r 3 



r cs~-r‘- s« * to r spresen t 










e^5 



e^> 



EXPONENTIATION 


In a like fashion, you can easily raise a number to a power (this is the 
some as mu'tip'yin 9 a number by itself a specified number of times). 

I he J (Up arrow) signifies exponentiation. 


PRINT 12 f 5 

243832 


This is the same as typing: 


PRINT 12 * 12 * 12 * 12 * 12 
248832 


TIP: 


in^BASIC nUm n u W ° yS ° f d0i " 9 thin9S ' ° ne SUch is nbbreviat- 
m 3 BASIC commands or keywords). A ? can be used in place of PRINT, for exam- 

abb 7 9 7 n VOU l PreSented with commands; Appendix D shows the 

SJ^fl eaC ° nd WhQt Wi " ^ diSP,0yed ^ 


The last example brings up another important point: many calcula¬ 
tions may be performed on the same line, and they can be of mixed 
types. 

You could calculate this problem: 




















Up to this point we've just used small numbers and simple examples. 
However, the Commodore 64 is capable of more complex calculations. 

You could, for example, add a number of large figures together. Try 
this, but don't use any commas, or you'll get an error: 


* 

? 123.45 + 345.78 + 7895.687 
8364.917 


That looks fine, but now try this: 


? 12123123.45 + 345.73 + 7395.687 
12131364.9 


If you took the time to add this up by hand, you would get a different 
result. 

What's going on here? Even though the computer has a lot of power, 
there's a limit to the numbers it can handle. The Commodore 64 can 
work with numbers containing 10 digits. However when a number is 
printed, only nine digits are displayed. 

So in our example, the result was "rounded" to ft in the proper 
range. The Commodore 64 rounds up when the next digit is five or more; 
it rounds down when the next digit is four or less. 

Numbers between 0.01 and 999,999,999 are printed using standard 
notation. Numbers outside this range are printed using scientific nota¬ 
tion. 

Scientific notation is just a process of expressing a very large or small 
number as a power of 10. 

If you type: 



4 * 



e-s 





? 123800080000800800 
1.23E+17 
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This is the same as 1.23 * 10|l7 and is used just to keep things tidy. 
There is a limit to the numbers the computer can handle, even in 
scientific notation. These limits are: 

Largest: ± 1.70141183E + 38 

Smallest (different from zero): ± 2.93873588 —39 


PRECEDENCE 

If you tried to perform some mixed calculations different from the 
examples we showed earlier, you might not have gotten the results that 

you expected. The reason is that the computer performs calculations in a 
certain order. 

In this calculation: 

20 + 8/2 

you can't tell whether the answer should be 24 or 14 until you know in 
which order to perform the calculations. If you add 20 to 8 divided by 2 
(or 4), then the result is 24. But, if you add 20 plus 8 and then divide by 
2 the answer is 14. Try the example and see what result you get 
The reason you got 24 is because the Commodore 64 performs calcu¬ 
lations left to right according to the following: 

First: - rni nus sign indicating negative numbers 

Second: | exponentiation, left to right 
Third: 7 multiplication and divisions, left to right 

Fourth: +- addition and subtraction, left to right 

Follow along according to the order of precedence, and you will see 
that m the above example the division was performed first and then the 
addition to get a result of 24. 

Make up some problems of your own and see if you can follow along 
and predict the results according to the rules set down above. 

There's also an easy way to alter the precedence process by using 
parentheses to set off which operations you want performed first. 

For example, if you want to divide 35 by 5-plus-2 you type: 
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you will get 35 divided by 5 with 2 added to the answer, which is not 
what you intended at all. To get what you really wanted, try this: 


? 35 / <5 + 2> 
5 


What happens now is that the computer evaluates what is contained 
in the parentheses first. If there are parentheses within parentheses, the 
innermost parentheses are evaluated first. 

Where there are a number of parentheses on a line, such as: 


? <12 + 9 > # <6 + 1 > 

147 


the computer evaluates them left to right. Here 21 would be multiplied 
by 7 for the result of 147. 


COMBINING THINGS 

Even though we've spent a lot of time in areas that might not seem 
very important, the details presented here will make more sense once 
you start to program, and will prove invaluable. 

To give you an idea how things fit in place, consider the following: 
how could you combine the two types of print statements we ve exam¬ 
ined so far to print something more meaningful on the screen? 

We know that by enclosing something within quote marks prints that 
information on the screen exactly as it was entered, and by using math 
operators, calculations can be performed. So why not combine the two 
types of PRINT statements like this: 


SEMICOLON MEANS NO SPACE. 












Even though this might seem a bit redundant, what we've done is 
simply use both types of print statements together. The first part prints 
5 9-' exactly as it was typed. The second part does the actual work 

and prints the result, with the semicolon separating the message part of 
the statement from the actual calculation. 

You can separate the parts of a mixed print statement with punctua¬ 
tion for various formats. Try a comma in place of the semicolon and see 
what happens. 

For the curious, the semicolon causes the next part of the statement to 
be printed immediately after the previous part, without any spaces The 
comma does something different. Even though it is an acceptable 
separator, it spaces things out more. If you type: 


? 2,3,4,5,6 
2 
6 


the numbers will be printed across the screen and down on to the next 
line. 

The Commodore 64's display is organized into 4 areas of 10 columns 
each. The comma tabs each result into the next available area Since 
we asked for more information to be printed than would fit on one line 
(we tried to fit five 10-column areas on one line) the last item was moved 
down to the next line. 

The basic difference between the comma and semicolon in formatting 
PRINT statements can be used to our advantage when creating more 

complex displays: it will allow us to create some sophisticated results 
very easily. 
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THE NEXT STEP 


Up to now we've performed some simple operations by entering a 
single line of instructions into the computer. Once EES was de¬ 
pressed, the operation that we specified was performed immediately. 
This is called the IMMEDIATE or CALCULATOR mode. 

But to accomplish anything significant, we must be able to have the 
computer operate with more than a single line statement. A number of 
statements combined together is called a PROGRAM and allows you to 
use the full power of the Commodore 64. 

To see how easy it is to write your first Commode re 64 program, try 
this: 

Clear the screen by holding the EBHI key, and then depressing the 
key. 

Type NEW and press ESIS- (This just clears out any numbers that 
might have been left in the computer from your experimenting.) 

Now type the following exactly as shown (Remember to hit 
after each line) 


10 ?"COMMODORE 64" 
20 GOTO 10 

■ 



Now, type RUN and hit —watch what happens. Your screen 

will come alive with COMMODORE 64. After you've finished watching 
the display, hit to stop the program. 


A number of important concepts were introduced in this short pro¬ 
gram that are the basis for all programming. 

Notice that here we preceded each statement with a number. This 
LINE number tells the computer in what order to work with each state¬ 
ment. These numbers are also a reference point, in case the program 
needs to get back to a particular line. Line numbers can be any whole 
number (integer) value between 0-63,999. 


10 PRINT "COMMODORE 64' 

T-STATEMENT 

“-LINE NUMBER 
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COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
BREfiK IN 10 
READY 


It is good programming practice to number lines in increments of 
10 in case you need to insert some statements later on. 

PRINL ° Ur Pr ° 9ram also used another BASIC command, 
GOTO. This instructs the computer to go directly to a particular line and 
pertorm it, then continue from that point. 

» 10 PRINT "COMMODORE 64" 

1 -20 GOTO 10 


in our example, the program prints the message in line 10, goes to 
the next line (20), which instructs it to go back to line 10 and print the 
message over again. Then the cycle repeats. Since we didn't give the 
computer a way out of this lo op, the p rogram will cycle endlessly, until 
we physically stop it with the key. 

Once you've stopped the program, type: LIST. Your program will be 
displayed, intact, because it's still in the computer's memory. Notice, 
too, that the computer converted the ? into PRINT for you. The program 
can now be changed, saved, or run again. 

Another important difference between typing something in the im¬ 
mediate mode and writing a program is that once you execute and 
clear the screen of an immediate statement, it's lost. However, you can 
always get a program back by just typing LIST. 

By the way, when it comes to abbreviations don't forget that the 
computer may run out of space on a line if you use too many. 
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EDITING TIPS 


If you make a mistake on a line, you have a number of editing 
options. 

1. You can retype a line anytime, and the computer will automatically 
substitute the new line for the old one. 

2. An unwanted line can be erased by simply typing the line number 


RETURN 


3. You can also easily edit an existing line, using the cursor keys and 
editing keys. 


Suppose you made a typing mistake in a line of the example. To 
correct it without retyping the entire line, try this: 

Type LIST, then using the IHlIIAl and hlMaaalll kevs together move the 
cursor up until it is positioned on the line that needs to be changed. 

Now, use the cursor-right key to move the cursor to the character you 
want to change, typing the change over the old character. Now hit 
and the corrected line will replace the old one. 

If you need more space on the line, position the cursor where the 
space is needed and hit QQQJ and at the same time and a 

space will open up. Now just type in the additional information and hit 
. Likewise, you can delete unwanted characters by placing the 
cursor to the right of the unwanted character and hitting the 
key. 

To verify that changes were entered, type LIST again, and the cor¬ 
rected program will be displayed! And lines don't have to be entered in 
numerical order. The computer will automatically place them in the 
proper sequence. 

Try editing our sample program on page 33 by changing line 10 and 
adding a comma to the end of the line. Then RUN the program again. 


10 PRINT "COMMODORE", 


* DON'T FORGET TO MOVE THE 
CURSOR PAST LINE 20 BEFORE 
YOU RUN THE PROGRAM. 


VARIABLES 

Variables are some of the most used features of any programming 
language, because variables can represent much more information in 
the computer. Understanding how variables operate will make comput¬ 
ing easier and allow us to accomplish feats that would not be possible 
otherwise. 
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COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
BREAK IN 10 
RERDV 


COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
COMMODORE COMMODORE 
C OMMODORE COMMODORE 
COMMODORE COMMODORE 


Imagine a number of boxes within the computer that can each hold a 
number or a string of text characters. Each of these boxes is to be 
labeled with a name that we choose. That name is called a variable 
and represents the information in the respective box. 

For example, if we say: 

10 X% = 15 

20 X = 23.5 

30 X$ = "THE SUM OF X%+X = " 


The computer might represent the variables like this: 

X% 15 

X 23.5 

X$ THE SUM OF X%+X = 

A variable name represents the box, or memory location, where the 
current value of the variable is stored. As you can see, we can assign 

either an integer number, floating point number, or a text string to a 
variable. 

The % symbol following a variable name indicates the variable will 

represent an integer number. The following are valid integer variable 
names: 
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A% 

X% 

Al% 

NM% 


The '$' following the variable name indicates the variable will repre¬ 
sent a text string. The following are examples of string variables: 

A$ 

X$ 

Ml$ 

Floating point variables follow the same format, with the type indi¬ 
cator: 

A1 

X 

Y 

Ml 

In assigning a name to a variable there are a few things to keep in 
mind. First, a variable name can have one or two characters. The first 
character must be an alphabetic character from A to Z; the second 
character can be either alphabetic or numeric (in the range 0 to 9). A 
third character can be included to indicate the type of variable (integer 
or text string), % or $. 

You can use variable names having more than two alphabetic 
characters, but only the first two are recognized by the computer. So 

PA and PARTNO are the same and would refer to the same variable 
box. 

The last rule for variable names is simple: they can't contain any 
BASIC keywords (reserved words) such as GOTO, RUN, etc. Refer back 
to Appendix D for a complete list of BASIC reserved words. 

To see how variables can be put to work, type in the complete pro¬ 
gram that we introduced earlier and RUN it. Remember to hit 
after each line in the program. 


NEW 

10 xx = 15 

20 X = 23.5 

30 >'.$■ = "THE SUM OF XX + X = “ 
40 PRINT "XX = XX, "X = "; X 
50 PRINT X$; XX + X 






















5 will re pre¬ 
aches: 


*~e type indi- 


3 " -gs to keep in 

** - :*:'cre r s. The first 
Z; Hie second 

-e 'c-ge 0 to 9 . A 

*oe c - :c e ' *e g e r 

*Hon two alphabetic 
« by the computer. So 

f *ne 5.3*r»e • aria die 


0*0 QfQ- 



% 
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If you did everything as shown, you should get the following result 
printed on the screen. 


RUN 


= 15 X = 23.5 


THE SUM OF XX + x = - 

*8.5 

REfiDV 


■ 



WeVe put together all the tricks learned so far to format the display 
as you see it and print the sum of the two variables 

In lines 10 and 20 we assigned an integer value to X% and assigned a 
floating point value to X. This puts the number associated with the vari- 
a e in its box. In line 30, we assigned a text string to X$. Line 40 
combines the two types of PRINT statements to print a message and the 

°2! ,Z ond , x - 1 "“ 50 pr,n,s ,hs °4»<i » x, 

and the sum of X% and X. 

ident? tha J. eVen ,^ OU9h X is used as Part of each variable name, the 
identifiers % and $ makp Y v* i 

three distinct variable, ' ' X$ UmqUe ' thUS 

But variables are much more powerful. If you change their value the 
new value replaces the original value in the same box. This allows'you 
to write a statement like: y 

X = X + 1 

This would never be accepted in normal algebra, but is one of the 
most used concepts in programming. It means: take the current value of 
X, add one to it and place the new sum into the box representing X 


IF . . . THEN 

Armed with the ability to easily update the value of variables, 
now try a program such as: 


we can 
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NEW 

10 CT = 0 

2© ?"COMMODORE 64" 

30 CT = CT + 1 
40 IF CT < 5 THEN 20 
50 END 
RUN 

COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 


What we've done is introduce two new BASIC commands, and pro¬ 
vided some control over our runaway little print program introduced at 
the start of this chapter. 

IF . . . THEN adds some logic to the program. It says IF a condition 
holds true THEN do something. IF the condition no longer holds true, 
THEN do the next line in the program. 

A number of conditions can be set up in using an IF . . . THEN state¬ 
ment: 


SYMBOL 

< 

> 

< > 

> = 

< = 

The use of any one of these 
powerful. 


10 

CT = 

0 

-» 20 

?"COMMODORE 64" 

30 

CT = 

CT + 1 

40 

IF CT 

< 5 THEN 20 

50 

END 



MEANING 
Less Than 
Greater Than 
Equal To 
Not Equal To 

Greater Than or Equal To 

Less Than or Equal To 

conditions is simple, yet surprisingly 
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In the sample program, we've set up a "loop" that has some con¬ 
straints placed on it by saying: IF a value is less than some number 
THEN do something. 

Line 10 sets CT (CounT) equal to 0. Line 20 prints our message. Line 30 
adds one to the variable CT. This line counts how many times we do the 
loop. Each time the loop is executed, CT goes up by one. 

Line 40 is our control line. If CT is less than 5, meaning we've exe¬ 
cuted the loop less than 5 times, the program goes back to line 20 and 
prints again. When CT becomes equal to 5—indicating 5 COMMODORE 

64's were printed—the program goes to line 50, which signals to END 
the program. 

Try the program and see what we mean. By changing the CT limit in 
line 40 you can have any number of lines printed. 

IF . . . THEN has a multitude of other uses, which we'll see in future 
examples. 


FOR 


NEXT LOOPS 


There is a simpler, and preferred way to accomplish what we did in 

the previous example by using a FOR . . . NEXT loop. Consider the 
following: 


10 FOR CT = 1 TO 5 
20 PRINT “COMMODORE F4‘ 
•38 NEXT CT 

RUN 

COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 
COMMODORE 64 


As you can see, the program has become much smaller and more 
direct. 


CT starts at 1 in line 10. Then, line 20 does some printing. In Line 


30 
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CT is incremented by 1. The NEXT statement in line 30 automatically 
sends the program back to line 10 where the FOR part of the FOR . . . 
NEXT statement is located. This process will continue until CT reaches the 
limit you entered. 

The variable used in a FOR . . . NEXT loop can be incremented by 
smaller amounts than 1, if needed. 

Try this: 


NEW 



10 FOR NB = 1 TO 

10 STEP .5 


20 PRINT NB, 



30 NEXT NB 



RUN 



1 1.5 

cL 

2.5 

3 3.5 

4 

4.5 

5 5.5 

6 

6.5 

7 7.5 

8 

8 . 5 

9 9.5 

10 



If you enter and run this program, youll see the numbers from 1 to 
10, by .5, printed across the display. 

Ail we're doing here is printing the values that NB assumes as it goes 
through the loop. 

You can even specify whether the variable is increasing or decreas¬ 
ing. Substitute the following for line 10: 

10 FOR NB = 10 to 1 STEP -.5 

and watch the opposite occur, as NB goes from 10 to 1 in descending 
order. 
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INTRODUCTION 

The next few chapters have been written for people who have be¬ 
come relatively familiar with the BASIC programming language and the 
concepts necessary to write more advanced programs. 

For those of you who are just starting to learn how to program, you 
may find some of the information a bit too technical to understand 
completely. But take heart. . . because for these two fun chapters, 
SPRITE GRAPHICS and CREATING SOUND, we've set up some simple 
examples that are written for the new user. The examples will give you 
a good idea of how to use the sophisticated sound and graphics 
capabilities available on your COMMODORE 64. 

If you decide that you want to learn more about writing programs in 
BASIC, we've put a bibliography (Appendix N) in the back of this man¬ 
ual. 

If you are already familiar with BASIC programming, these chapters 
will help you get started with advanced BASIC programming techniqu¬ 
es. More detailed information can be found in the COMMODORE 64 
PROGRAMMER'S REFERENCE MANUAL, available through your local 
Commodore dealer. 
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SIMPLE ANIMATION 


Let's exercise some of the Commodore 64's graphic capabilities by 
putting together what we've seen so far, together with a few new con¬ 
cepts. If you're ambitious, type in the following program and see what 
happens. You will notice that within the print statements we can also 
include cursor controls and screen commands. When you see something 


SHIFT 


CRSR LEFT/ RIGHT key. The screen will show the graphic representation 
of a cursor left (two vertical reversed bars). In the same way, pressing 


SHIFT CLR/HOME 


NEW 



10 REM BOUNCING BALL 


20 PRINT " {CLR/HOME}- 

25 FOR X - 1 TO 10 s PRINT "{CRSR/DOWN}": NEXT 
30 FOR BL = 1 TO 40 
40 



50 

60 

70 

75 


80 FOR BL ^40 TO 1 STEP -1 

90 PRINT"f{CRSR LEFT}{CRSR LEFT}•{CRSR LEFT}"; 

100 FOR TM = 1 TO 5 

110 NEXT TM 

120 NEXT BL 

130 GOTO 20 


TIP: 


All words in this text will be completed on one line. However, as long as you don't 


hit EESSlOi your 64 will automatically move to the next line even in the middle of a 
word. 


The program will display a bouncing ball moving from left to right, 
and back again, across the screen. 

If we look at the program closely, (shown on page 44) you can see 
how this feat was accomplished. 

Line 10 is a REMark that just tells what the program does; it has no 
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10 REM BOUNCING E*ALL 

|->"20 PRINT " {CLR/HOME} " 

|—^25 FOR X = 1 TO 1© : PRINT "{CRSR/DOWN}“: NEXT 

30 FOR BL = 1 TO 40 

40 PRINT" •{CRSR LEFT}";:REM <• is a SHIFT-Q> 
p-50 FOR TM = 1 TO 5 
L-60 NEXT TM 

1 -70 NEXT BL 

75 REM MOVE BALL RIGHT TO LEFT 
|—*~S0 FOR BL = 40 TO 1 STEP -1 

90 PRINT" {CRSR LEFT}{CRSR LEFT}*{CRSR LEFT} 
i-*~100 FOR TM = 1 TO 5 
'—110 NEXT TM 

1 -120 NEXT BL 

1 -130 GOTO 20 

effect on the program itself. Line 20 clears the screen of any informa- 
tion. 

Line 25 PRINTS 10 cursor-down commands. This just positions the ball 
in the middle of the screen. If line 25 was eliminated the ball would 
move across the top line of the screen. 

Line 30 sets up a loop for moving the ball the 40 columns from the left 

to right. 

Line 40 does a lot of work. It first prints a space to erase the previous 
ball positions, then it prints the ball, and finally it performs a cursor-left 
to get everything ready to erase the current ball position again. 

The loop set up in lines 50 and 60 slows the ball down a bit by delay¬ 
ing the program. Without it, the ball would move too fast to see. 

Line 70 completes the loop that prints balls on the screen, set up in 
line 30. Each time the loop is executed, the ball moves another space to 
the right. As you notice from the illustration, we have set up a loop 
within a loop. 

This is perfectly acceptable. The only time you get in trouble is when 
the loops cross over each other. Ifs helpful in writing programs to check 
yourself as illustrated here to make sure the logic of a loop is correct. 

To see what would happen if you cross a loop, reverse the statements 
in lines 60 and 70. You will get an error because the computer gets 
confused and cannot figure out whafs going on. 

Lines 80 through 120 just reverse the steps in the first part of the 
program, and move the ball from right to left. Line 90 is slightly differ¬ 
ent from line 40 because the ball is moving in the opposite direction (we 
have to erase the ball to the right and move to the left). 
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And when that's all done the program goes back to line 20 to start the 
whole process over again. Pretty neat! To stop the program hold 
down and hit 

For a variation on the program, edit line 40 to read: 


40 PRINT 


TO MAKE THE 9 , HOLD THE SHIFT 
' KEY DOWN AND HIT THE LETTER "Q." 


Run the program and see what happens now. Because we left out the 
cursor control, each ball remains on the screen until erased by the ball 
moving right to left in the second part of the program. 

INPUT 

Up to now, everything within a program has been set before it is run. 
Once the program was started, nothing could be changed. INPUT 
allows us to pass new information to a program as it is running and 
have that new information acted upon. 

To get an idea of how INPUT works, type NEW and enter this 

short program: 


10 INPUT 

20 PRINT "YOU TYPED: 

30 PRINT 
40 GOTO 10 
RUN 

? COMMODORE 64^^ 

YOU TYPED: COMMODORE 64^ 


What happens when you run this program is simple. A question mark 
will appear, indicating that the computer is waiting for you to type 
something. Enter any character, or group of characters, from the 
keyboard and hit The computer will then respond with "YOU 

TYPED followed by the information you entered. 

This may seem very elementary, but imagine what you can have the 
computer do with any information you enter. 

You can INPUT either numeric or string variables, and even have the 
INPUT statement prompt the user with a message. The format of INPUT is: 

INPUT "PROMPT MESSAGE";VARIABLE 



- PROMPT MUST BE 38 CHARACTERS OR LESS. 


45 















Or, just: 



INPUT VARIABLE 


NOTE: To get out of this program hold down the 

keys. 


and 


The following program is not only useful, but demonstrates a lot of 
what has been presented so far, including the new input statement. 


NEW 

1 REM TEMPERATURE CONVERSION PROGRfiM 
5 PRINT "{CLR/HOME}" 

10 PRINT "CONVERT FROM FAHRENHEIT OR CELSIUS 
<F/C>": INPUT AT 

20 IF H$ = " V* THEN 20 _ 

39 IF A* = "F" THEN 100 

40 IF R $ O "C" THEN 10 
50 INPUT "ENTER DEGREES CELSIUS: " ;C 
60 F = <0*50/5+32 

70 PRINT C?" DEG. CELSIUS = "; F;" DEG. 

FAHRENHEIT" 

80 PRINT 
90 GOTO 10 

100 INPUT "ENTER DEGREES FAHRENHEIT: 

110 C = < F-32 >*5/9 

120 PRINT F; M DEG. FAHRENHEIT = ";C; n DEG. 

CELSIUS" 

130 PRINT 
140 GOTO 10 



If you enter and run this program, you'll see INPUT in action. 

Line 10 uses the input statement to not only gather information, but 
also print our prompt. Also notice that we can ask for either a number or 
string (by using a numeric or string variable). 

Lines 20, 30, and 40 do some checks on what is typed in. In line 20, if 
nothing is entered (just W-BRfUM is hit), then the program goes back to 
line 10 and requests the input again. In line 30, if F is typed, you know 
the user wants to convert a temperature in degrees Fahrenheit to Cel¬ 
sius, so the program branches to the part that does that conversion. 

Line 40 does one more check. We know there are only two valid 
choices the user can enter. To get to line 40, the user must have typed 
some character other than F. Now, a check is made to see if that char¬ 
acter is a C; if not, the program requests input'again. 

This may seem like a lot of detail, but it is good programming prac- 
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tice. A user not familiar with the program can become very frustrated if 

it does something strange because a mistake was made entering infor- 
motion. 

Once we determine what type of conversion to perform, the program 
does the calculation and prints out the temperature entered and the 
converted temperature. 

The calculation is just straight math, using the established formula for 
temperature conversion. After the calculation is finished and answer 
printed, the program loops back and starts over. 

After running, the screen might look like this: 


CONVERT FROM FRHRENHEIT OR CELSIUS •:FT .. z-c 
ENTER DEGREES FAHRENHEIT: 32 
32 DEG. FAHRENHEIT = 0 DEG. CELSIUS 

CONVERT FROM FAHRENHEIT OR CELSIUS <F/C>: o' 


After running the program, make sure to save it on disk or tape. This 
program, as well as others presented throughout the manual, can form 
the base of your program library. 


GET 


GET allows youtoinput one character at a time from the keyboard 
without hitting This really speeds entering data in many appli¬ 

cations. Whatever key is hit is assigned to the variable you specify with 
GET. 


The following routine illustrates how GET works: 


NEW 

1 PRINT '* {CLR/HOME} " 

10 GET ft$: IF = "l" THEN 10 

20 PRINT R$; T - 

30 GOTO 10 



















If you RUN the program, the screen will clear and each time you hit a 
key, line 20 will print it on the display, and then GET another character. 
It is important to note that the character entered will not be displayed 
unless you specifically PRINT it to the screen, as we've done here. 

The second statement on line 10 is also important. GET continually 
works, even if no key is pressed (unlike INPUT that waits for a response), 
so the second part of this line continually checks the keyboard until a key 
is hit. 

See what happens if the second part of line 10 is eliminated. 

To stop this program you can hit the an< ^ keys. 

The first part of the temperature conversion program could easily be 
rewritten to use GET. LOAD the temperature conversion program, and 
modify lines 10, 20 and 40 as shown: 


10 PRINT "CONVERT FROM FAHRENHEIT OR CELSIUS 
<F/C>" 

20 GET A$: 

40 IF A* O "C" 


IF A$ = 


THEN 20 
THEN 20 



This modification will make the program operate smoother, as nothing 
will happen unless the user types in one of the desired responses to 
select the type of conversion. 

Once this change is made, make sure you save the new version of the 
program. 




ME* 


10 FOR * = : 

20 PfcIMT 

30 NE>^ 



€32952301 

4323*3724 




Z' , vwC*’5 r it 


s-o.'C r*zr - •-iirrcs T^rr s 




cor. nr c i® 


RANDOM NUMBERS AND OTHER FUNCTIONS 


"tTnc 1 


The Commodore 64 contains a number of functions that are used to 
perform special operations. Functions could be thought of as built-in 
programs included in BASIC. But rather than typing in a number of 
statements each time you need to perform a specialized calculation, you 
just type the command for the desired function and the computer does 
the rest. 

Many times when designing a game or educational program, you 
need to generate a random number, to simulate the throw of dice, for 
example. You could certainly write a program that would generate these 
numbers, but an easier way to call upon the RaNDom number function. 

To see what RND actually does, try this short program: 







2* MHMT oflflMKI* 
HUH 


5.472389^ 
3. I 

3 . 1&331895 
9.32527884 
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NEW 


10 FOR X = 1 TO 10, 
20 PRINT RND(1>,- 
30 NEXT 


IF Y0U nt E Mm?n U rU HE COMMA YOURUST) 
OF NUMBERS WILL APPEAR 
AS 1 COLUMN 


After running the program, you will see a displ^ like this? 


. 73928069? 

• 664673958 

.256373663 

.0123442287 

.682952381 

3.90587279E-04 

.402343724 

.879308926 

■ 158209062! 

.245596701 


Your numbers don't match? Well, if they did we would all be in 
trouble, as they should be completely random! 

Try running the program a few more times to verify that the results are 
always different. Even if the numbers don't follow any pattern, you 

should start to notice that some things remain the same every time the 
program is run. 

First, the results are always between 0 and 1, but never equal to 0 or 
1. This will certainly never do if we want to simulate the random toss of 
dice, since we're looking for numbers between 1 and 6 

The other important feature to look for is that we are dealing with real 
numbers (with decimal places). This could also be a problem since 
whole (integer) numbers are often needed. 

. ™* re are ° number of simple ways to produce numbers from the 
RND function in the range desired. 

Replace line 20 with the following and run the program again: 


20 PRINT 6*RND< 

: i >... 


RUN 



3.60563664 

5.47238963 

3.19265054 

3.16331095 

3-32527884 

4.53660853 

8.40858227 

4.39547668 

5.50620749 

4.17090293 
























That cured the problem of not having results larger than 1, but we still 
have the decimal part of the result to deal with. Now, another function 
can be called upon. 

The INTeger function converts real numbers into integer values. 

Once more, replace line 20 with the following and run the program to 
see the effect of the change: 


2U PRINT 

INT <;6#RN0<1 

> > . 



RUN 








1 

0 

2 

4 


5 

S 

0 

1 





That took care of a lot, getting us closer to our original goal of 
generating random numbers between 1 and 6. If you examine closely 
what we generated this last time, you'll find that the results range from 
0 to 5, only. 

As a last step, add a one to the statement, as follows: 

20 PRINT INT(6*RND(1))+1, 

Now, we have achieved the desired results. 

In general, you can place a number, variable, or any BASIC expres¬ 
sion within the parentheses of the INT function. Depending on the range 
desired, you just multiply the upper limit by the RND function. For 
example, to generate random numbers between 1 and 25, you could 
type: 

20 PRINT INT(25*RND(1))+ 1 

The general formula for generating a set of random numbers in a 
certain range is: 

NUMBER=INT(LOWER LIMIT+(UPPER-LOWER + l)*RND(l)) 

GUESSING GAME 

Since we've gone to some lengths to understand random numbers, 
why not put this information to use? The following game not only illus- 
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trates a good use of random numbers, but also introduces some addi 
tional programming theory. 

In running this program, a random number, NM, will be generated 


NEW 


1 REM NUMBER GUESSING GAME 

2 PRINT "{CLR/HOME}" 

5 INPUT "ENTER UPPER LIMIT FUR GUESS ■■ l\ t 
10 NM = INT<LI*RND<1»+1 ' L1 

15 CN = 0 

20 PRINT "I'VE GOT THE NUMBER. ":PRINT 
30 INPUT "WHAT'S VOUR GUESS"; Gil 
35 CN = CN + 1 

40 IF GU > NM THEN PRINT "MV NUMBER IS 
LOWER"; PRINT : GOTO 30 
50 IF GU < NM THEN PRINT "MV NUMBER IS 
HIGHER": PRINT : GOTO 30 
60 PRINT "GREAT! VOU GOT MV NUMBER" 

65 PRINT "IN ONLV "CN ; "GUESSES. PR I NT 

i® PRINT "DO VOU WANT TO TRV ANOTHER <V/N> 

80 GET AN*: IF AN*="" THEN 80 

90 IF AN* = "V" THEN 2 

100 IF AN* <> "N" THEN 70 

110 END 


•INDICATES NO 
SPACE AFTER 
QUOTATION MARI* 


You can specify how large the number will be at the start of the pro¬ 
gram. Then, it's up to you to guess what the number is. 

A sample run follows along with an explanation. 


ENTER UPPER LIMIT FOR GUESS? 25 
I'VE GOT THE NUMBER. 

WHAT'S VOUR GUESS ? IS 
MV NUMBER IS HIGHER. 

WHAT'S VOUR GUESS ? 20 
MV NUMBER IS LOWER. 

WHAT'S VOUR GUESS ? 19 
GREAT! VOU GOT MV Nl IMBER 
IN ONLY 3 GUESSES. 

DO VOU WANT TO TRV ANOTHER <Y/N> ? 













IF/THEN statements compare your guess to the number generated. 
Depending on your guess, the program tells you whether your guess was 
higher or lower than the random number generated. 

From the formula given for determining random number range, see if 
you can add a few lines to the program that allow the user to also 
specify the lower range of numbers generated. 

Each time you make a guess, CN is incremented by 1 to keep track of 
the number of guesses. In using the program, see if you can use good 
reasoning to guess a number in the least number of tries. 

When you get the right answer, the program prints out the "GREAT! 
YOU GOT MY NUMBER" message, along with the number of tries it took. 
You can then start the process over again. Remember, the program 
generates a new random number each time. 


PROGRAMMING TIPS: 

In lines 40 and 50, a colon is used to separate multiple statements on a single line. 
This not only saves typing, but in long programs will conserve memory space. 

Also notice in the IF/THEN statements on the same two lines, we instructed the 
computer to PRINT something, rather than immediately branching to some other point 
in the program. 

The last point illustrates the reason behind using line numbers in increments of 10: 
After the program was written, we decided to add the count part. By just adding 
those new lines at the end of the program, numbered to fall between the proper 
existing lines, the program was easily modified. 












YOUR ROLL 


The following program simulates the throw of two dice. You can enjoy 
it as it stands, or use it as part of a larger game. 


e ^ 9 

e ^ 9 


5 PRINT “ Care +0 try your luck? " 

10 PRINT "RED DICE = ";INT<6#RND<1>>+l 
20 PRINT "WHITE DICE = ";INT<6*RND<1>>+l 
30 PRINT "HIT SPftCE BRR FOR RNOTHER ROLL" 1 PRINT 
40 GET R$: IF R$ = THEN 40 
50 IF fl$ = CHR$<32> THEN 10 

Care to try your luck? 

From what you've learned about random numbers and BASIC, see if 
you can follow what is going on. 
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RANDOM GRAPHICS 
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As a final note on random numbers, and as an introduction to design¬ 
ing graphics, take a moment to enter and run this neat little program: 


10 PRINT "{CLR/HOME}” 

20 PRINT CHR$<205. 5 + RNCKl'O : 
40 GOTO 20 


As you may have expected, line 20 is the key here. Another function, 
CHR$ (Character String), gives you a character, based on a standard 
code number from 0 to 255. Every character the Commodore 64 can 
print is encoded this way (see Appendix F). 

To quickly find out the code for any character, just type: 

PRINT ASC("X") 

where X is the character you're checking (this can be any printable 
character, including graphics). The response is the code for the char¬ 
acter you typed. As you probably figured out, "ASC" is another function, 
which returns the standard "ASCII" code for the character you typed. 
You can now print that character by typing: 

PRINT CHR$(X) 

If you try typing: 

PRINT CHR$ (205); CHR$(206) 

you will see the two right side graphic characters on the M and N keys. 
These are the two characters that the program is using for the maze. 

By using the formula 205.5 + RND(l) the computer will pick a random 
number between 205.5 and 206.5. There is a fifty-fifty chance of the 
number being above or below 206. CHR$ ignores any fractional values, 
so half the time the character with code 205 is printed and the remain¬ 
ing time code 206 is displayed. 

If you'd like to experiment with this program, try changing 205.5 by 
adding or subtracting a couple tenths from it. This will give either char¬ 
acter a greater chance of being selected. 
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COLOR AND GRAPHICS 


Up to now we've explored some of the sophisticated computing 
capabilities of the Commodore 64. But one of its most fascinating fea¬ 
tures is an outstanding ability to produce color and graphics. 

You've seen a quick example of graphics in the "bouncing ball" and 
"maze" programs. But these only touched on the power you command. 
A number of new concepts will be introduced in this section to explain 
graphic and color programming and show how you can create your own 
games and advanced animation. 

Because we've concentrated on the computing capabilities of the ma¬ 
chine, all the displays we've generated so far were a single color (light 
blue text on a dark blue background, with a light blue border). 

In this chapter we'll see how to add color to programs and control all 
those strange graphic symbols on the keyboard. 


PRINTING COLORS 

As you discovered if you tried the color alignment test in Chapter 1, 
you can change text colors by simply holding the BSTfll key and one of 
the color keys. This works fine in the immediate mode, but what hap¬ 
pens if you want to incorporate color changes in your programs? 

When we showed the "bouncing ball" program, you saw how 
keyboard commands, like cursor movement, could be incorporated 
within PRINT statements. In a like way, you can also add text color 
changes to your programs. 

You have a full range of 16 text colors to work with. Using the^^H 
key and a number key, the following colors are available: 

12 3 4 5 6 7 8 

Black White Red Cyan Purple Green Blue Yellow 

If you hold down the S key along with the appropriate number 
key, these additional eight colors can be used: 


1 2 
Orange Brown 


3 

Lt. 

Red 


4 

Gray 1 


5 

Gray 2 


6 

Lt. 

Green 


7 

Lt. 

Blue 


8 

Gray 3 


TYPE NEW, and experiment with the following. Hold down the^^S 
key and at the same time hit the key. Next, hit the Q key without 
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ho dmg down the ©3 key. Now, while again depressing theQSkey 
at same time hit theQkey. Release theQQkey and hit thTffkey 

° V ? the numbers ' alternating with the letters, and type " the 

word RAINBOW as follows: /P Tne 

1° PRINT'^R^A^ I ^N^B^O^W" 

gbsbbbobqb 

RUN 

RAINBOW 

Just as cursor controls show as graphic characters within the quote 
character'"' StQtementS ' C °'° r C °" tro,s are als ° represented as graphic 

In the previous example when you held download typedRa 
was displayed. &fcaQ displayed a Each color control will 

display its unique graphic code when used in this way. The table shows 
the graphic representations of each printable color control. 


CTRL 

7 

[ CTRL 

8 


COLOR 

display 

keyboard 

COLOR 

display 

BLACK 

1 

so 

ORANGE 

n 

WHITE 

3 

SB 

BROWN 

m 

RED 

H 

SB 

LT. RED 

m 

CYAN 

E 

SB 

GRAY 1 

m 

PURPLE 

m 

SB 

GRAY 2 

M 

GREEN 

D 

SO 

LT. GREEN 

■I 

BLUE 

B 

SB 

LT. BLUE 

□ 

YELLOW 

B 

SB 

GRAY 3 

■ ■ 

■ ■ 


Even though the PRINT s.ot.men. may |ook „ b „ 
creen, when you RUN ,h. progrant, only ,h. ,e„ will be displayed. And 
it w,ll aetotnancally change colors according to the color control, 
placed in the print statement. y 

sinlT.VRmT eX ,T P '" 0< r r ° Wn - any nun,b ' r ° f w»hi" a 
° , statement. Remember, too, you con us. the second s.t of 

text colors by using the Commodore key and the number keys. 


TIP: 


"REA W Dr"° tiCe a ? 6r 7 nin9 7 r ° 9ram C °' 0r ° r m ° de changes, that the 

READY prompt and any additional text you type is the same as the las. color or 

node change. To get back to the normal display, remember to depress: 
and 
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COLOR CHR$ CODES 


Take a brief look at Appendix F, then turn back to this section. 
You may have noticed in looking over the list of CHR$ codes in 
Appendix F that each color (as well as most other keyboard controls, 
such as cursor movement) has a unique code. These codes can be 


printed directly to obtain the same results as typing 


and the 


appropriate key within the PRINT statement. 
For example, try this: 




The text should now be green. In many cases, using the CHR$ func¬ 
tion will be much easier, especially if you want to experiment with 
changing colors. The following program is a different way to get a rain¬ 
bow of colors. Since there are a number of lines that are similar (40- 
110) use the editing keys to save a lot of typing. See the notes after the 
listing to refresh your memory on the editing procedures. 



NEW 


1 REM AUTOMATIC COLOR BARS 

5 PRINT CHR*<147> ; REM CHRSC147>= CLR/HOME 
10 PRINT CHR$<18>; " " ;sREM REVERSE BAR 


20 CL = INT<8*RN0a>> + l 

30 ON CL GOTO 40 r 50 , r 607080 .r 90100 .,110 

40 PRINT CHR$<5>;: GOTO 10 

50 PRINT CHR$<28>;: GOTO 10 

60 PRINT CHR$<30>;s GOTO 10 

70 PRINT CHR*<31>;: GOTO 10 

80 PRINT CHRt<144>;s GOTO 10 

90 PRINT CHR$<156>;: GOTO 10 

100 PRINT CHR$<158>;: GOTO 10 

110 PRINT CHR*<159>;: GOTO 10 
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Type lines 5 through 40 normally. Your display should look like this: 


1 REM AUTOMATIC COLi'if? bAR'- 

! ,. REM CLR/HOME 

iecL I = T ih?Srnd | i ;> +1 " ;:REri Reverse bars. 

40 PRINT ChS<5>:;:%o?6 ? !0 80 ' 90 ' 100 ' 110 


fcUITING NOTES 


Use the CRSR-UP key to position the cursor on line 40. Then type 5 

r^AP* 4 ^ 4 °'u NeXt ' USe -^- C RSR - RIGH T To move over to the 5 in 
the C H R$ parenthes es Hit B DBI to open up a space and type 

28 Now ,ust hit Bli with the cursor anywhere on the line 
The display should now look like this: 


NEW 


10 

20 

30 

50 


1 REM RUTOMflTIC COLOR BRR3 
5 ’ • S .. REM C ^*<14?>= CLR/HOME 

CL ^ = T I NT < 8#RND 1 :> > +1 ” ; : REN REVERSE BAR 

!Sint SS<5;?M^r;f ' S0 ' ,00 ' u,! 


Don't worry. Line 40 is still there. LIST the program and see. Using the 
same procedure, continue to modify the last line with a new line number 
and CHR$ code until all the remaining lines have been entered. See we 
told you the editing keys would come in handy. As a final check, list' the 
entire program to make sure all the lines were entered properly before 
you RUN it. 

Here is a short explanation of what's going on. 

You've probably figured out most of the color bar program by now 
except for some strange new statement in line 30. But let's quickly see 
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what the whole program actually does. Line 5 prints the CHR$ code for 
CLR/HOME. 

Line 10 turns reverse type on and prints 5 spaces, which turn out to be 
a bar, since they're reversed. The first time through the program the bar 
will be light blue, the normal text color. 

Line 20 uses our workhorse, the random function to select a random 
color between 1 and 8. 

Line 30 contains a variation of the IF . . . THEN statement which is 
called ON . . . GOTO. ON . . . GOTO allows the program to choose 
from a list of line numbers to go to. If the variable (in this case CL) has a 
value of 1, the first line number is the one chosen (here 40). If the value 
is 2, the second number in the list is used, etc. 

Lines 40-110 just convert our random key colors to the appropriate 
CHR$ code for that color and return the program to line 10 to PRINT a 
section of the bar in that color. Then the whole process starts over 
again. 

See if you can figure out how to produce 16 random numbers, ex¬ 
pand ON . . . GOTO to handle them, and add the remaining CHR$ 
codes to display the remaining 8 colors. 

PEEKS AND POKES 

No, we're not talking about jabbing the computer, but we will be able 
to "look around" inside the machine and "stick" things in there. 

Just as variables could be thought of as a representation of "boxes" 
within the machine where you placed your information, you can also 
think of some specially defined "boxes" within the computer that repre¬ 
sent specific memory locations. 

The Commodore 64 looks at these memory locations to see what the 
screen's background and border color should be, what characters are to 
be displayed on the screen — and where — and a host of other tasks. 

By placing, "POKEing," a different value into the proper memory lo¬ 
cation, we can change colors, define and move objects, and even 
create music. 

These memory locations could be represented like this: 


53280 


53281 


53282 


53283 

X 


Y 






BORDER BACKGROUND 

COLOR COLOR 
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On page 60 we showed just four locations, two of which control the 
screen and background colors. Try typing this: 


POKE 53281,7 


RETURN 


The background color of the screen will change to yellow because we 
placed the value '7' for yellow — in the location that controls the 
background color of the screen. 

Try POKEing different values into the background color location, and 
see what results you get. You can POKE any value between 0 and 255, 
but only 0 through 15 will work. 

The actual values to POKE for each color are: 


1 0 

BLACK 

8 

ORANGE 

1 

WHITE 

9 

BROWN 

2 

RED 

10 

Light RED 

3 

CYAN 

11 

GRAY 1 

4 

PURPLE 

12 

GRAY 2 

5 

GREEN 

13 

Light GREEN 

6 

BLUE 

14 

Light BLUE 

7 

YELLOW 

15 

GRAY 3 


Can you think of a way to display the various background and border 
combinations? The following may be of some help: 


HEW 


10 

FOR 

BR = 0 TO 15 

20 

FOR 

BO = 0 TO 15 

30 

POKE 

53280.r BR 

40 

POKE 

53281, BO 

50 

FOR 

X = 1 TO 2008: NEXT X 

60 

NEXT 

BO: NEXT BR 

RUN 



Two simple loops were set up to POKE various values to change the 
background and border colors. The DELAY loop in line 50 just slows 
things down a bit. 
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For the curious, try: 

? PEEK (53280) AND 15 

You should get a value of 15. This is the last value BORDER was given 
and makes sense because both the background and border colors are 
GRAY (value 15) after the program is run. 

By entering AND 15 you eliminate all other values except 1-15, be¬ 
cause of the way color codes are stored in the computer. Normally you 
would expect to find the same value that was last POKEd in the location. 
In general, PEEK lets us examine a specific location and see what value 
is presently there. Can you think of a one line addition to the program 
that will display the value of BACK and BORDER as the program runs? 
How about this: 

25 PRINT CHR$( 147); "BORDER = ";PEEK (53280) AND 15, "BACK¬ 
GROUND = "; PEEK (53281) AND 15 

SCREEN GRAPHICS 

In all the printing of information that you've done so far, the computer 
normally handled information in a sequential fashion: one character is 
printed after the next, starting from the current cursor position (except 
where you asked for a new line, or used the '/ in PRINT formatting). 

To PRINT data in a particular spot you can start from a known place 
on the screen and PRINT the proper number of cursor controls to format 
the display. But this takes program steps and is time consuming. 

But just as there are certain spots in the Commodore 64's memory to 
control color, there are also locations that you can use to directly control 
each location on the screen. 


SCREEN MEMORY MAP 

Since the computer's screen is capable of holding 1000 characters (40 
columns by 25 lines) there are 1000 memory locations set aside to han¬ 
dle what is placed on the screen. The layout of the screen could be 
thought of as a grid, with each square representing a memory location. 

And since each location in memory can contain a number from 0 to 
255, there are 256 possible values for each memory location. These 
values represent the different characters the Commodore 64 can display 
(see Appendix E). By POKEing the value for a character in the appro- 
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priate screen memory location, that character will be displayed in the 
proper position. 


COLUMN 

0 10 20 30 39 

1063 

1024 —- r i i i i iti i n i ri i i i i i i i i i i i i i i i i i n i i n i m 

1064 
1104 
1144 
1184 
1224 
1264 
1304 
1344 
1384 
1424 
1464 
1504 
1544 
1584 
1624 
1664 
1704 
1744 
1784 
1824 
1864 
1904 
1944 
1984 


t 

2023 


Screen memory in the Commodore 64 normally begins at memory 
location 1024, and ends at location 2023. Location 1024 is the upper left 
corner of the screen. Location 1025 is the position of the next character 
to the right of that, and so on down the row. Location 1063 is the 
right-most position of the first row. The next location following the last 
character on a row is the first character on the next row down. 

Now, let's say that you're controlling a ball bouncing on the screen. 
The ball is in the middle of the screen, column 20, row 12. The formula 
for calculation of the memory location on the screen is: 



POINT = 1024 + 


COLUMN 

ROW 



where X is the column and Y is the row. 

Therefore, the memory location of the ball is: 




1024 + 20 + 480 or 1524 


COLUMN 
ROW (40* 12) 
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Clear the screen with 


SHIFT 


CLR/HOME 


and type: 


POKE 1524,81 
POKE 55796,1 

I-COLOR 

-LOCATION 


COLOR MEMORY MAP 


A ball appears in the middle of the screen! You have placed a char¬ 
acter directly into screen memory without using the PRINT statement. 
The ball that appeared was white. However there is a way to change 
the color of an object on the screen by altering another range of mem¬ 
ory. Type: 


POKE 55796,2. 


LOCATION 

COLOR 


The ball's color changes to red. For every spot on the Commodore 64's 
screen there are two memory locations, one for the character code, and 
the other for the color code. The color memory map begins at location 
55296 (top left-hand corner), and continues on for 1000 locations. The 


COLUMN 

0 10 20 30 39 


55335 



56295 
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same color codes, from 0-15, that we used to change border and 
background colors can be used here to directly change character colors. 

The formula we used for calculating screen memory locations can be 
modified to give the locations to POKE color codes. The new formula is: 

COLOR PRINT = 55296 + X + 40*Y 


MORE BOUNCING BALLS 

Here's a revised bouncing ball program that prints directly on the 
screen with POKEs, rather than using cursor controls within PRINT state¬ 
ments. As you will see after running the program, it is much more flexi¬ 
ble than the earlier program, and will lead up to programming much 
more sophisticated animation. 

NEW 

10 PRINT “{CLR/HOME}" 

20 POKE 53280,7 : POKE 53281,13 

30 X = 1 s V = 1 

40 DX = 1 s DV = 1 

50 POKE 1024 + X + 40*V,81 

66 FOR T = 1 TO 10 : NEXT 

70 POKE 1024 + X + 40*V,32 

30 X = X + DX 

90 IF X < = 0 OR X > = 39 THEN DX = -DX 
100 V = V + DV 

110 IF V < = 0 OR V >= 24 THEN DV = -DV 
120 GOTO 50 

Line 10 clears the screen, and line 20 sets the background to light 
green with a yellow border. 

The X and Y variables in line 30 keep track of the current row and 
column position of the ball. The DX and DY variables in line 40 are the 
horizontal and vertical direction of the ball's movement. When a +1 is 
added to the X value, the ball is moved to the right; when —1 is added, 
the ball moves to the left. A +1 added to Y moves the ball down a row; 
a —1 added to Y moves the ball up a row. 

Line 50 puts the ball on the screen at the current cursor position. Line 
60 is the familiar delay loop, leaving the ball on the screen just long 
enough to see it. 

Line 70 erases the ball by putting a space (code 32) where the ball 
was on the screen. 
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Line 80 adds the direction factor to X. Line 90 tests to see if the ball 
has reached one of the side walls, reversing the direction if there s a 
bounce. Lines 100 and 110 do the same thing for the top and bottom 
walls. 

Line 120 sends the program back to display and moves the ball 
again. 

By changing the code in line 50 from 81 to another character code, 
you can change the ball to any other character. If you change DX or DY 
to 0 the ball will bounce straight instead of diagonally. 

We can also add a little more intelligence. So far the only thing you 
checked for is the X and Y values getting out of bounds for the screen. 
Add the following lines to the program. 

21 FOR L = 1 TO 10 .^/SCREEN CODE 

25 POKE 1824 + INT <RND < 1 > # 1 000 >, 16b v- _ , ^ 

27 NEXT L 

85 IF PEEK<1024 + X + 40#Y> = 166 THEN DX = -DX: 

GOTO SO 

105 IF PEEKO024 + X + 40#Y> = 166 THEN DY = -DY = 
GOTO 10 0 

Lines 21 to 27 put 10 blocks on the screen in random positions. Lines 
85 and 105 check (PEEK) to see if the ball is about to bounce into a 
block, and changes the ball's direction if so. 
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SPRITE GRAPHICS 


• Introduction to Sprites 

• Sprite Creation 

• Additional Notes on Sprite 

• Binary Arithmetic 




■ 'M : 

N - 

' i r :;_; - ',, 

) ■ ' . 

' - 

*7 h : J: ' - v i 


m 


wiSt & ' ’ Sw 




; HI 

’H’ 




















INTRODUCTION TO SPRITES 


In previous chapters dealing with graphics, we saw that graphic 
symbols could be used in PRINT statements to create animation and add 
chartlike appearances to our displays. 

A way was also shown to POKE character codes in specific screen 
memory locations. This would then place the appropriate characters di¬ 
rectly on the screen in the right spot. 

Creating animation in both these cases requires a lot of work because 
objects must be created from existing graphic symbols. Moving the ob¬ 
ject requires a number of program statements to keep track of the ob¬ 
ject and move it to a new spot. And, because of the limitation of using 
graphic symbols, the shape and resolution of the object might not be as 
good as required. 

Using sprites in animated sequences eliminates a lot of these prob¬ 
lems. A sprite is a high-resolution programmable object that can be 
made into just about any shape—through BASIC commands. The object 
can be easily moved around the screen by simply telling the computer 
the position the sprite should be moved to. The computer takes care of 
the rest. 

And sprites have much more power than just that. Their color can be 
changed; you can tell if one object collides with another; they can be 
made to go in front and behind another; and they can be easily ex¬ 
panded in size, just for starters. 

The penalty for all this is minimal. However, using sprites requires 
knowing some more details about how the Commodore 64 operates and 
how numbers are handled within the computer. It's not as difficult as it 
sounds, though. Just follow the examples and you'll be making your own 
sprites do amazing things in no time. 

SPRITE CREATION 

Sprites are controlled by a separate picture-maker in the Commodore 
64. This picture maker handles the video display. It does all the hard 
work of creating and keeping track of characters and graphics, creating 
colors, and moving around. 

This display circuit has 46 different "ON/OFF" locations which act like 
internal memory locations. Each of these locations breaks down into a 
series of 8 blocks. And each block can either be "on" or "off". We'll get 
into more detail about this later. By POKEing the appropriate decimal 
value in the proper memory location you can control the formation and 
movement of your sprite creations. 







In addition to accessing many of the picture making locations we will 
also be using some of the Commodore 64's main memory to store infor¬ 
mation (data) that defines the sprites. Finally, eight memory locations 
directly after the screen memory will be used to tell the computer exactly 
which memory area each sprite will get its data from. 

As we go through some examples, the process will be very 
straightforward, and you'll get the hang of it. 

So let's get on with creating some sprite graphics. A sprite object is 24 
dots wide by 21 dots long. Up to eight sprites can be controlled at a 
time. Sprites are displayed in a special independent 320 dot wide by 
200 dot high area. However, you can use your sprite with any mode, 
high-resolution, low-resolution, text etc. 

Say you want to create a balloon and have it float around the sky. 
The balloon could be designed as in the 24 by 21 grid on page 70. 

The next step is to convert the graphic design into data the computer 
can use. Get a piece of notebook or graph paper and set up a sample 
grid that is 21 spaces down and 24 spaces across. Across the top write 
128,64,32,16,8,4,2,1, three times (as shown) for each of the 24 
squares. Number down the left side of the grid 1-21 for each row. Write 
the word DATA at the end of each row. Now fill in the grid with any 
design or use the balloon that we have. It's easiest to outline the shape 
first and then go back and fill in the grid. 

Now if you think of all the squares you filled in as "on" then substitute 
a 1 for each filled square. For the one's that aren't filled in, they're "off" 
so put a zero. 

Starting on the first row, you need to convert the dots into three sepa¬ 
rate pieces of data the computer can read. Each set of 8 squares is 
equal to one piece of data called a byte in our balloon. Working from 
the left, the first 8 squares are blank, or 0, so the value for that series of 
numbers is 0. 

The middle series looks like this (again a 1 indicates a dot, 0 is a 
space): 


128 

64 

32 

16 

8 

4 

2 

1 

0 

1 

1 

1 

1 

1 

1 

1 

t 

t 

t 

t 

t 

t 

t 

t 


0 + 64 + 32 +16+ 8 + 4+ 2+1= 127 

The third series on the first row also contains blanks, so it, too, equals 
zero. Thus, the data for the first line is: 

DATA 0, 127, 0 
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SERIES . SERIES . SERIES 

1 j 2 ] 3 

128 32 8 2 128 32 8 2 128 32 8 2 


COLUMN 


The series that make up row two are calculated like this: 


Series 3: 


1 

1 

0 

0 

0 

0 

0 

0 


Series 2: 


Series 1: 


0 

0 

0 

0 

0 

0 

0 

1 


t t 


128+64 


255 


192 


For row 2, the data would be: 

DATA 1,255,192 

In the same way, the three series that make up each remaining row 
would be converted into their decimal value. Take the time to do the 
remainder of the conversion in this example. 

Now that you have the data for your object, how can it be put to use? 
Type in the following program and see what happens. 
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*-"5 

C--9 

C"* 


I REM UP, UP, RND RWRY! 

5 PRINT "{CLR/HOME}" 

10 V= 53248 s REM STRRT OF DISPLRV CHIP 

II POKE V+21,4 s REM ENRBLE SPRITE 2 

12 POKE 2042,13 s REM SPRITE 2 DRTR FROM 13TH BLK 
20 FOR N = 0 TO 62: RERD Q : POKE 832+N,Q: NEXT 

30 FOR X = 0 TO 200 *- - GETS ITS INFO. FROM DATA* 

40 POKE V+4,X: REM UPDRTE X COORDINRTES 
50 POKE V+5,X: REM UPDRTE V COORDINRTES 
60 NEXT X 

70 GOTO 30/ INFO read in from q * 

200 DRTR^C127,0,1,255,192,3,255,224,3,231,224 
210 DRTR 7,217,240,7,223,240,7,217,240,3,231,224 
220 DRTR 3,255,224,3,255,224,2,255,160,1,127,64 
230 DRTR 1,62,64,0,156,128,0,156,128,0,73,0,0,73,0 
240 DRTR 0,62,0,0,62,0,0,62,0,0,28,0 

-FOR MORE DETAIL ON READ & DATA SEE CHAPTER 8. 

If you typed everything correctly, your balloon is smoothly flying 


across the sky (page 72). 

In order to understand what happened, first you need to know what 
picture making locations control the functions you need. These locations, 
called registers,could be illustrated in this manner: 


Register(s) Description 


0 

1 

2-15 

16 

21 

29 

23 

39 - 46 


X coordinate of sprite 0 
Y coordinate of sprite 0 
Paired like 0 and 1 for sprites 1-7 
Most Significant Bit—X Coordinate 
Sprite appear: l=appear 0 = disappear 
Expand sprite in "X" Direction 
Expand sprite in "Y" Direction 
Sprite 0—7 color 



In addition to this information you need to know from which 64 byte 
section sprites will get their data (1 byte is not used). 

This data is handled by 8 locations directly after screen memory: 



2040 

41 

1 42 

43 

44 

45 

46 

2047 


t 

t 

t 

t 

t 

t 

T 

t 

SPRITE 0 

i 

2 

3 

4 

5 

6 

7 


Now let's outline the exact procedure to get things moving and finally 
write a program. 
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ACTUAL SCREEN PHOTO 


There are only a few things necessary to actually create and move an 
object. 

1. Make the proper sprite(s) appear on the screen by POKEing into lo¬ 
cation 21 a 1 for the bit which turns on the sprite. 

2. Set sprite pointer (locations 2040-7) to where sprite data should be 
read from. 

3. POKE actual data into memory. 

4. Through a loop, update X and Y coordinates to move sprite around. 

5. You can, optionally, expand the object, change colors, or perform a 
variety of special functions. Using location 29 to expand your sprite in 
the "X" direction and location 23 in the "Y" direction. 

There are only a few items in the program that might not be familiar 
from the discussion so far. 

In line 10; 

V=53248 

sets V to the starting memory location of the video chip. In this way we 
just increase V by the memory number to get the actual memory loca¬ 
tion. The register numbers are the ones given on the sprite register map. 
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In line 1 1, 

POKE V+21,4 

makes sprite 2 appear by placing a 4 in what is called the sprite enable 
register (21) to turn on sprite 2. Think of it like this: 


SPRITES 



Each sprite level is represented in section 21 of the sprite memory and 
4 happens to be sprite level 2. If you were using level 3 you would put a 
1 in sprite 3 which has a value of 8. In fact if you used both sprites 2 
and 3 you would put a 1 in both 4 and 8. You would then add the 
numbers together just like you did with the DATA on your graph paper. 
So, turning on sprites 2 and 3 would be represented as V + 21,12. 


In line 12; 

POKE 2042,13 


instructs the computer to get the data for sprite 2 (location 2042) from 
the 13th area of memory. You know from making your sprite that it 
takes up 63 sections of memory. You may not have realized it, but those 
numbers you put across the top of your grid equal what is known as 3 
bytes of the computer. In other words each collection of the following 
numbers, 128,64,32,16,8,4,2,1 equals 1 byte of computer memory. 
Therefore with the 21 rows of your grid times the 3 bytes of each row, 
each sprite takes up 63 bytes of memory. 

20 FOR N = 0 to 62: READ f Q: NEXT 


1 WHOLE SPRITE 


This line handles the actual sprite creation. The 63 bytes of data that 
represent the sprite you created are READ in through the loop and 
POKEd into the 13th block of memory. This starts at location 832. 


30 FOR X = 0 TO 200 

40 POKE V+4^X --~ fSPRrfr27x COORDINATE^ 

50 POKE — ^SP_rTtE~2's Y COORDINAt TI 

If you remember from school the X coordinate represents an objects 
horizontal movement across the screen and the Y coordinate represents 
the sprite's vertical movement across the screen. Therefore as the values 
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of X change in line 30 from 0 to 200 (one number at a time) the sprite 
moves across the screen DOWN and TO THE RIGHT one space for each 
number. The numbers are READ by the computer fast enough to make 
the movement appear to be continuous, instead of 1 step at a time. If 
you need more details take a look at the register map in Appendix O. 

When you get into moving multiple objects, it would be impossible for 
one memory section to update the locations of all eight objects. There¬ 
fore each sprite has its own set of 2 memory sections to make it move on 
the screen. 

Line 70 starts the cycle over again, after one pass on the screen. The 
remainder of the program is the data for the balloon. Sure looks differ¬ 
ent on the screen, doesn't it? 

Now, try adding the following line: 

25 POKE V+23,4 : POKE V+29,4: REM EXPAND 

and RUN the program again. The balloon has expanded to twice the 
original size! What we did was simple. By POKEing 4 (again to indicate 
sprite 2) into memory sections 23 and 29, sprite 2 was expanded in the 
X and Y direction. 

It's important to note that the sprite will start in the upper left-hand 
corner of the object. When expanding an object in either direction, the 
starting point remains the same. 

For some added excitement, make the following changes: 

11 POKE V+21,12 

12 POKE 2042,13 : POKE 2043,13 

30 FOR X = 1 to 190 

45 POKE V+6,X 

55 POKE V+7,190 —X 

A second sprite (number 3) has been turned on by POKEing 12 into the 
memory location that makes the sprite appear (V + 21). The 12 turns 
sprites 3 and 2 on (00001100 = 12). 

The added lines 45 and 55 move sprite 3 around by POKEing values 
into sprite 3's X and Y coordinate locations (V+6 and V+7). 

Want to fill the sky with even more action? Try making these addi¬ 


tions: 



28 IS REALLY 4JSPRITE 2) + 8 
! (SPRITE 3) + 16 (SPRITE 4) 


11 POKE V+21,28^- N -—- 

12 POKE 2042,13:POKE 2043,13:POKE 2044,13 
25 POKE V+23,12 : POKE V+29,12 

48 POKE V+8,X 
58 POKE V+9,100 
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In line 11 this time, another sprite (4) was made to appear by POKE- 
ing 28 into the appropriate "on" location of the sprite memory section. 
Now sprites 2-4 are on (00011100 = 28). 

Line 12 indicates that sprite 4 will get its data from the same 
memory area (13th 63 section area) as the other sprites by POKEing 
2044,13. 

In line 25, sprites 2 and 3 are expanded by POKEing 12 (Sprites 2 
and 3 on) into the X and Y direction expanded memory locations (V+23 
and V + 29). 

Line 48 moves sprite 3 along the X axis. Line 58 positions sprite 3 
halfway down the screen, at location 100. Because this value does not 
change, like it did before with X = 0 to 200, sprite 3 just moves horizon¬ 
tally. 

ADDITIONAL NOTES ON SPRITES 

Now that you've experimented with sprites, a few more words are in 
order. First, you can change a sprite's color to any of the standard 16 
color codes (0-15) that were used to change character color. These can 
be found in Chapter 5 or in appendix G. 

For example, to change sprite 1 to light green, type: POKE 
V + 40,13 (be sure to set V = 53248). 

You may have noticed in using the example sprite programs that 
the object never moved to the right-hand edge of the screen. This was 
because the screen is 320 dots wide and the X direction register can 
only hold a value up to 255. How then can you get an object to move 
across the entire screen? 

There is a location on the memory map that has not been men¬ 
tioned yet. Location 16 (of the map) controls something called the most 
significant bit (MSB) of the sprite's X direction location. In effect, this 
allows you to move the sprite to a horizontal spot between 256 and 320. 

The MSB of X register works like this: after the sprite has been 
moved to X location 255, place a value into memory location 16 repre¬ 
senting the sprite you want to move. For example, to get 2 to move to 
horizontal locations 256-320, POKE the value for sprite 2 which is (4) into 
memory location 16: 

POKE V+ 16,4. 

Now start from 0 again in the usual X direction register for sprite 2 
(which is in location 4 of the map). Since you are only moving another 64 
spaces, X locations would only range between 0 and 63 this time. 
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This whole concept is best illustrated with a version of the original 
sprite 1 program: 


10 V= 53 2*48: POKE V+21,4 : POKE 2042,13 

20 FOR N = 0 TO 62 : RERD Q : POKE 832+N,Q : NEXT 

25 POKE V+5, 100 

30 FOR X = 0 TO 255 

40 POKE V+4,X 

50 NEXT 

60 POKE V+16,4 
70 FOR X = 0 TO 63 
80 POKE V+4, X 
90 NEXT 

100 POKE V+16,0 
110 GOTO 30 


Line 60 sets the most significant bit for sprite 2. Line 70 starts moving 
the standard X direction location, moving sprite 2 the rest of the way 
across the screen. 

Line 100 is important because it "turns off" the MSB so that the 
sprite can start moving from the left edge of the screen again. 

To define multiple sprites, you may need additional blocks for the 
sprite data. You can use some of BASIC's RAM by moving BASIC. Before 
typing or loading your program type: 

POKE44,16: POKE 16*256,0:NEW 

Now, you can use blocks 32 through 41 (locations 2048 through 4095) to 
store sprite data. 


BINARY ARITHMETIC 

It is beyond the scope of this introductory manual to go into details of 
how the computer handles numbers. We will, however, provide you with 
a good base for understanding the process and get you started on 
sophisticated animation. 

But, before you get too involved we have to define a few terms: 

BIT —This is the smallest amount of information a computer can store. 
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Think of a BIT as a switch that is either "on" or "off". When a BIT is 
"on" it has a value of 1; when a BIT is "off" it has a value of 0. 
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After BIT, the next level is BYTE. 

BYTE —This is defined as a series of BITS. Since a BYTE is made up of 
8 BITS, you can actually have a total of 256 different combinations 
of BITS. In other words, you can have all BITS "off" so your BYTE 
will look like this: 


128 

64 

32 

16 

8 

4 

2 

1 

0 

0 

0 

.. 0 1 

0 

0 

0 

0 

and its 

128 

value 

64 

will be 0. 

32 

All BITS 

16 

"on" is: 

8 

4 

2 

1 

1 

1 

1 

> 1 

i 1 

1 

1 



which is 128 + 64 + 32+16 + 8 + 2+1=255. 

The next step up is called a REGISTER. 

REGISTER — Defined as a block of BYTES strung together. But, in this 
case each REGISTER is really only 1 BYTE long. A series of REGIS¬ 
TERS makes up a REGISTER MAP. REGISTER MAPS are charts like 
the one you looked at to make your BALLOON SPRITE. Each REGIS¬ 
TER controls a different function, like turning on the SPRITE is really 
called the ENABLE REGISTER. Making the SPRITE longer is the EX¬ 
PAND X REGISTER, while making the SPRITE wider is the EXPAND Y 
REGISTER. Keep in mind that a REGISTER is a BYTE that performs a 
specific task. 

Now lefs move on to the rest of BINARY ARITHMETIC. 


BINARY TO DECIMAL CONVERSION 


128 

64 

32 

De 

16 

icima! Va 

8 

lue 

4 

2 

1 


0 

0 

0 

0 

0 

0 

0 

1 

2t0 

0 

0 

0 

0 

0 

0 

1 

0 

2tl 

0 

0 

0 

0 

0 

1 

0 

0 

2|2 

0 

0 

0 

0 

1 

0 

0 

0 

2f3 

0 

0 

0 

1 

0 

0 

0 

0 

2|4 

0 

0 

1 

0 

0 

0 

0 

0 

2|5 

0 

1 

0 

0 

0 

0 

0 

0 

2|6 

1 

0 

0 

0 

0 

0 

0 

0 

2f 7 
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Using combinations of all eight bits, you can obtain any decimal value 
from 0 to 255. Do you start to see why when we POKEd character or 
color values into memory locations the values had to be in the 0-255 
range? Each memory location can hold a byte of information. 

Any possible combination of eight 0's and l's will convert to a 
unique decimal value between 0-255. If all places contain a 1 then the 
value of the byte equals 255. All zeros equal a byte value of zero; 
"00000011" equals 3, and so on. This will be the basis for creating data 
that represents sprites and manipulating them. As just one example, if 
this byte grouping represented part of a sprite (0 is a space, 1 is a 
colored area): 

2 7 2 6 2 5 2 4 2 3 2 2 _ T _ 2 ° 


128 + 64 + 32 -1- 16 + 8 + 4 + 2 + 1 + = 255 

Then we would POKE 255 into the appropriate memory location to 
represent that part of the object. 

TIP: 

To save you the trouble of converting binary numbers into decimal values—we'll 
need to do that a lot—the following program will do the work for you. It's a good 
idea to enter and save the program for future use. 

5 REM BINftRV TO DECIMRL CONVERTER 
10 INPUT “ENTER 8-BIT BINftRV NUMBER ;ft* 

12 IF LEN <fi*> O 8 THEN PRINT “8 BITS PLEftSE... M : 
GOTO 10 

15 TL = 0 s C = 0 

20 FOR X = 8 to 1 STEP -1 : C = C + 1 
30 TL = TL + VftL<MID$<R*,C,l>>*2|<X-l> 

40 NEXT X 

50 PRINT ft*.:” BINftRV " ?" = " ,;TL; U DECIMRL 11 
60 GOTO 10 

This program takes your binary number, which was entered as a string, and looks 
at each character of the string, from left to right (the MID$ function). The variable C 
indicates what character to work on as the program goes through the loop. 

The VAL function, in line 30, returns the actual value of the character. Since we 
are dealing with numeric characters, the value is the same as the character. For 
example, if the first character of A$ is 1 then the value would also be 1. 

The final part of line 30 multiplies the value of the current character by the proper 
power of 2. Since the first value is in the 2\7 place, in the example, TL would first 
equal 1 times 128 or 128. If the bit is 0 then the value for that place would also be 
zero. 

This process is repeated for all eight characters as TL keeps track of the running 
total decimal value of the binary number. 
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USING SOUND IF YOU'RE NOT A COMPUTER 
"PROGRAMMER" 

Most programmers use computer sound for two purposes: making 
music and generating sound effects. Before getting into the "intricacies" 
of programming sound, let's take a quick look at how a typical sound 
program is structured . . . and give you a short sound program you can 
experiment with. 

STRUCTURE OF A SOUND PROGRAM 

To begin with, there are five settings which you should know in order 
to generate sound on your COMMODORE 64: VOLUME, ATTACK/ DE¬ 
CAY, SUSTAIN/RELEASE(ADSR), WAVEFORM CONTROL and HIGH 
FREQUENCY/LOW FREQUENCY. The first three settings are usually set 
ONCE at the beginning of your program. The high and low frequency 
settings must be set for EACH NOTE you play. The waveform control 
starts and stops each note. 


SAMPLE SOUND PROGRAM 

Before you start you have to choose a VOICE. There are 3 voices. 
Each voice requires different sound setting numbers for Waveform, etc. 
You can play 1, 2 or 3 voices together but our sample uses only VOICE 


NUMBER 1. Type in this program 
RETURN key after each line: 

First clear sound chip. 

1. Set VOLUME at highest setting. 

2. Set ATTACK/DECAY rates to 
define how fast a note rises to and 
falls from its peak volume level (0 
to 255). 

3. Set SUSTAIN/RELEASE to define 
level to prolong note and rate to 
release it. 

4. Find the note/tone you want to 
play in the TABLE OF MUSICAL 
NOTES in Appendix M and enter 
the HIGH-FREQUENCY and LOW- 
FREQUENCY values for that note 
(each note requires 2 POKEs). 


ine by line ... be sure to hit the 

5 F0RL = 54272T054296: 
POKEL,0:NEXT 
10 POKE54296,15 
20 POKE54277,190 


30 POKE 54278,248 


40 POKE54273,17:POKE54272,37 


80 



5. S-c~ WAVBOttM r x 

-i s-e—~ 22 

t E - ■ - W* e 

DURATION =- •*« t -r 



*’« ujst rr**r 





IG 


I c l/* CVkJ 
i cm 


or* rr* 


oe—orngr* 1 ” r* cr- :* 


inrg or '* ONE cr oir ixfimoi' 


\iE4 



5 ** • SOL SC.-*--i — 






























5. Start WAVEFORM with one of 
4 standard settings (17, 33, 65 

or 129). 

6. Enter a time loop to set the 
DURATION of the note to be 
played (a quarter note is approx. 

250 but may vary since a longer 
program can affect the timing). 

7. Turn off note. 


50 POKE54276,17 


60 FORT= 1TO250:NEXT 


70 POKE54276,16 


^hejr the note you just created, type the word RUN and then hit the 
BSZSa key. To view the program type the word LIST and hit gBJIl-lM 
To change it, retype the lines you want to alter. 


MAKING MUSIC ON YOUR COMMODORE 64 


ou don t have to be a musician to make music on your COMMODORE 
64! All you need to know are a few simple numbers which tell your 
computer how loud to set the volume, which notes to play, how long to 
play them, etc. But first . . . here's a program which gives you a quick 
demonstration of the COMMODORE 64's incredible music capabilities, 
using only ONE of your computer's 3 separate voices. 

Type the word NEW and hit ■MlIrM to erase your previous pro¬ 
gram, then enter this program, type the word RUN and hit the B !HW.J!II 
key. 



5 REM MUSICAL SCALE «-- Title of program. 

7 FORL=54272T054296:POKEL,0 ; NEXT 

10 POKE 54296,15t-—s.» volum . „ ,.„ in9 (1J , 

20 POKE 54277,9 <- -s«s Attack/Decay 

Sustain/Release level (each note) 

~ Determines waveform (type of sounc 


30 POKE 54276,17< 


40 FORT=1TO300:NEXT 
50 READ At-- 


Duration (how long) each note plays. 
Reads first number in line 110 DATA. 
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60 READ B< -Reads second number in line 110 DATA. 

70 IFB = —1THENEND <- ENDS when it READs —1 in line 900. 

80 POKE 54273, A: POKE54272, B <-POKES the first number from DATA in line 110 (A= 17) 

as HIGH FREQUENCY and second number (B = 37) 
as LOW FREQUENCY. Next time program loops 
around it READS A as 19 and B as 63, and so on, 
and POKEs these numbers into the HIGH and LOW 
FREQUENCY locations. The number 54273 = HIGH 
FREQUENCY for VOICE1 and 54272 = LOW FRE¬ 
QUENCY for VOICE 1. 

85 POKE 54276,17 «-st^noie 

90 FORT = 1 TO250: N EXT: POKE54276, 1 6 Let it play then stop note 

95 FORT = 1TO50:NEXT <- Time for release. 

100 GOTO20 < - - -Loops back to reset CONTROL and play new note. 

110 DATA 17 37 19 63 21 154 22 227 Musical note values from note value chart in Appendix 
1 20 DATA 25, 1 77,28,2 1 4,32,94,34, 1 75 M Each pair of " umbers represents one note. For 

example, 17 and 37 represent "C" of the 4th oc¬ 
tave, 19 and 63 represent "D" and so on. 


900 DATA— 1, —1«- 

Tff 

K Rua/ 

K^TU R f 


When program reaches —1 it turns off HIGH/LOW 
FREQUENCY settings and ENDs as instructed in 
line 70. 


To change the sound to a "harpsichord," change Line 85 to read 
POKE54276,33 and Line 90 to read FORT= 1 TO250:NEXT:POKE54276,32 


and RUN the program again. (To change the line, hit the key 

to stop the program, type the word LIST and hitjjsj^yj, then retype 
the program line you want to change; the new line will automatically 
replace the old one). What we did here is change the "waveform" from 
a "triangular" shaped sound wave to a "sawtooth" wave. Changing the 
WAVEFORM can drastically change the sound produced by the COM¬ 
MODORE 64 . . . but . . . waveform is only one of several settings you 
can change to make different musical tones and sound effects! You can 
also change the ATTACK/DECAY rate of each note ... for example, to 
change from a "harpsichord" sound to a more "banjo" sound try chang¬ 
ing lines 20 and 30 to read: 


20 POKE54277,3 
30 POKE54278,0 <- 
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As you've just seen, you can make your COMMODORE 64 sound like 
se»in g e wo m rks SiCa inStrUmentS ‘ ^ take 0 closer look at how each sound 

IMPORTANT SOUND SETTINGS 

T tHe V ° IUme ° nd S6t * f ° the hi 9 hest level, type: 
OKE 54296,15. The volume setting ranges from 0 to 15 but you'll use 15 
most of the time. To turn "off" the volume, type: 5 

POKE 54296,0 

You only have to set the volume ONCE at the beginning of your pro¬ 
gram, since the same setting activates all three of the Commodore 64's 
VOICES. (Changing the volume during a musical note or sound effect 

can produce interesting results but is beyond the scope of this introduc- 

tion.) 

2. ADSR and WAVEFORM CONTROL SETTING -You've already seen 
how changing the waveform can change the sound effect from 
"xylophone" to "harpsichord." Each VOICE has its own WAVEFORM 
CONTROL SETTING which lets you define four different types of 
wavef°rm s: Triangle, Sawtooth, Pulse (Square) and Noise. The CON¬ 
TROL also activates the COMMODORE 64's ADSR feature, but we'll 

come back to this in a moment. A sample waveform start setting looks 

like this: 

POKE 54276,17 

where the first number (54276) represents the control setting for VOICE 1 
and the second number (17) represents the start for a triangular 
waveform. The settings for each VOICE and WAVEFORM combination 
are shown in the table below. 




ADSR AND WAVEFORM CONTROL SETTINGS 

CONTROL Not* Stmt/Ct An u_i_ 


VOICE 1 

54276 

17/16 

33/32 

ruuc 

65/64 

NOISE 

129/128 

VOICE 2 

54283 

17/16 

33/32 

65/64 

129/128 

VOICE 3 

54290 

17/16 

33/32 

65/64 

129/128 


Although the control registers are different for each voice the 
waveform settings are the same for each type of waveform. To see how 
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this works, look at Lines 85 and 90 in the musical scale program. In this 
program, immediately after setting the frequency in Line 80, we set the 
CONTROL SETTING for VOICE 1 in Line 85 by POKEing 54276,17. This 
turned on the CONTROL for VOICE 1 and set it to a TRIANGLE 
WAVEFORM (17). In Line 70 we POKE 54276,16, stopping the note. La¬ 
ter, we changed the waveform start setting from 17 to 33 to create a 
SAWTOOTH WAVEFORM and this gave the scale a "harpsichord" effect. 
See how the CONTROL SETTING and WAVEFORM interact? Setting the 
waveform is similar to setting the volume, except each voice has its own 
setting and instead of POKEing volume levels we're defining waveforms. 
Next, we'll look at another aspect of sound . . . the ADSR feature. 

3. ATTACK/DECAY SETTING —As we mentioned before, the ADSR 
CONTROL SETTING not only defines the waveform but it also activates 
the ADSR, or ATTACK/DECAY/SUSTAIN/RELEASE feature of the COM¬ 
MODORE 64. We'll begin by looking at the ATTACK/pECAY setting. The 
following chart shows the various AiTACK and DECAY levels for each 
voice. If you're not familiar with the concepts of sound attack and de¬ 
cay, you might think of "attack" as the rate at which a note/sound arises 
to its MAXIMUM VOLUME. The DECAY is the rate at which the note/ 
sound falls from its highest volume level back to the SUSTAIN level. The 
following chart shows the ATTACK/DECAY setting for each voice, and the 
numbers for each attack and decay setting. Note that YOU MUST 
COMBINE ATTACK AND DECAY SETTINGS BY ADDING THEM UP AND 
ENTERING THE TOTAL. For example, you can set a HIGH ATTACK rate 
and a LOW DECAY rate by adding the high attack number (64) to the 
low decay number (1). The total (65) will tell the computer to set the high 
attack rate and low decay rate. You can also increase the attack rates 
by adding them together (128 + 64 + 32 + 16 = MAX. ATTACK RATE 


of 240). 

ATTACK/DECAY RATE SETTINGS 

ATTACKDECAY HIGH MEDIUM LOW LOWEST HIGH MED. 


LOW LOWEST 
DECAY DECAY 


VOICE 1 

54277 

128 

64 

32 

16 

8 

4 

2 

1 

VOICE 2 

54284 

128 

64 

32 

16 

8 

4 

2 

1 

VOICE 3 

54291 

128 

64 

32 

16 

8 

4 

2 

1 


If you set an attack rate with no decay, the decay is automatically 
zero, and vice-versa. For example, if you POKE 54277,64 you set a 
medium attack rate with zero decay for VOICE 1. If you POKE 54277,66 
you set a medium attack rate and a low decay rate (because 66 = 64 + 2 
and sets BOTH settings). You can also add up several attack values, or 
several decay values. For example, you can add a low attack (32) and a 
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medium attack (64) for a combined attack rate of 96, then add a 
- ium decay of 4 and . . . presto . . . POKE 54277 100 
t , At ** Point, a sample program will better illustrate the effect. Type 
WOr ' lf and type in this program and RUN it: 

5 FOR L=54272TO54296:POKEL,0:NEXT<e- 

10 PRINT"HIT ANY KEY" -- 

20 POKE54296,15 - - 

30 POKE54277,64 


40 POKE54273,17:POKE54272,37«-_ 

60 GETK$:IFK$=""THEN60 -- 

70 POKE54276,17:FORT= 1 TO200:NEXT<- 
80 POKE54276,16:FORT = 1TO50:NEXT <_ 

90 GOTO20 <—- 


Duration the note plays. 

- Screen message. 

Set volume at highest level. 
Set Attack/Decay. 

-Poke one note into VOICE 1. 

- Check the keyboard. 

Set Waveform control (triangle). 

- Turn off settings. 

Loop back and do it again. 

WeVe USin9 V ° ICE 1 t0 Create one note at a time . . . with a 

riTACrDErAY CK ° nd ZER ° DECAY - THe ^ iS UnS 4 °- POKEin 9 the 
TACK/DECAY setting with the number 64 activates a MEDIUM attack 

rate The result sounds like so meone b ouncing a ball in an oil drum 
Now for the fun part. Hit the [M key to stop the program, then 
type the word LIST and hitB Now type this |ine ^ 

the new line 40 automatically replaces the old line 40): 

40 POKE 54277,190 






Type the word RUN and hit to see how it sounds. What we've 

mru attTJT S6Veral Qttack and d6Cay sett * n g s ■ The settings 
are u .^ ,GH ATTACK (128 > + LOW ATTACK(32) + LOWEST ATTACK (16) 
GH DECAY (8) + MEDIUM DECAY(4) + LOW DECAY(2) = 190 

This effect sounds like a sound an oboe or other "reedy" instrument 
might make. If you'd like to experiment, try changing the waveform and 
attack/decay numbers in the musical scale example to see how an 
oboe sounds. Thus ... you can see that changing the attack/decay 
rates can be used to create different types of sound effects 

4. SUSTAIN/RELEASE SETTING-Like Attack/Decay, the SUSTAIN/ 
RELEASE setting is activated by the ADSR/WAVEFORM Control SUSTAIN/ 
RELEASE lets you "extend" (SUSTAIN) a portion of a particular sound, like 
the "sustain pedal" on a piano or organ which lets you prolong a note 
Any note or sound can be sustained at any one of lb' levels The 
SUSTAIN/RELEASE Setting may be used with a FOR . . . NEXT loop to 
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determine how long the note will be held at SUSTAIN volume before 
being released. The following chart shows the numbers you have to 
POKE to reach different SUSTAIN/RELEASE, rates. 


SUSTAIN/RELEASE RATE SETTINGS 


SUSTAIN/ 

RELEASE 

HIGH 

MEDIUM 

LOW 

LOWEST 

HIGH 

MED. 

LOW 

LOWEST 

CONTROL 

SETTING 

SUSTAIN 

SUSTAIN 

SUSTAIN 

SUSTAIN 

RELEASE 

RELEASE 

RELEASE 

RELEASE 

VOICE 1 

54278 

128 

64 

32 

16 

8 

4 

2 

1 

VOICE 2 

54285 

128 

64 

32 

16 

8 

4 

2 

1 

VOICE 3 

54292 

128 

64 

32 

16 

8 

4 

2 

1 


As an example, if you're using VOICE1, you can set a HIGH SUSTAIN 
LEVEL by typing: POKE 54278,128 or you could combine a HIGH SUSTAIN 
LEVEL with a LOW RELEASE RATE by adding 128 + 2 and then POKE 
54278,130. Here's the same sample program we used in the ATTACK/ 
DECAY section above . . . with a SUSTAIN/RELEASE feature added. 
Notice the difference in sounds. 


5 FO RL=54272T 054296: POKEL,0: NEXT < 

10 POKE54296,15 <- 

20 POKE54277,64 +- 

30 POKE54278,128<- 

40 POKE54273,17:POKE54272,37 +-- 

50 PRINT"HIT ANY KEY" 4- 

60 GETK$:IFK$=" "THEN60 <- 

70 POKE54276,17:FORT = 1 TO200:NEXT + 
80 POKE54276,16:FORT = 1 TO50:NEXT *— 
90 GOTO60 <- 


-’Duration the note plays. 

Set volume at highest level. 
Set Attack/Decay. 

Set Sustain/Release 

POKE one note into VOICE 1. 

Screen message. 

Check the keyboard. 

Set Waveform control (triangle). 
Turn off settings. 

Loop back and do it again. 






In Line 30, we tell the computer to SUSTAIN the note at a HIGH SUS¬ 
TAIN LEVEL (128 from chart above) . . . after which the tone is released 
in Line 80. You can vary the duration of a note by changing the "count" 
in Line 70. To see the effect of using the release function try changing 
Line 30 to POKE54278,89 (SUSTAIN = 80, RELEASE = 9). 

5. CHOOSING VOICES AND SETTING HIGH/LOW FREQUENCY 
SOUND VALUES —Each individual note on the Commodore 64 requires 
TWO SEPARATE POKE COMMANDS ... one for HIGH FREQUENCY and 
one for LOW FREQUENCY. The MUSICAL NOTE VALUE table in Appendix 
M shows you the corresponding POKEs you need to play any note in the 
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POK^rOMMANinc' 9111 ° CtaVe ran 9 e - The HIGH and LOW FREQUENCY 
° . COMMANDS are different for each VOICE you use-this allows 

ZZZZ21* VOiCe$ ind6Pendent,y * ^ "«* or 

nr I he HIGH u and L LOW FREQUENCY POKE COMMANDS for each voice 

the" middle ^ ** N ° TE VALUES for 


VOICE NUMBER POKE 
* FREQUENCY NUMBER 

VOICE1/HIGH 
VOICE1/LOW 


VOICE2/HIGH 

VOICE2/LOW 


VOICE3/HIGH 

IVOICE3/LOW 


54273 

54272 

54280 

54279 


54287 

54286 


SAMPLE MUSICAL NOTES —FIFTH OCTAVE 


38 

126 

~38 

126 


40 

200 


38 

126 


D# 


40 

200 


40 

200 


F F# 


45 

198 


45 

198 


45 

198 


48 

127 


48 

127 


48 

127 


G# 


54 

111 


57 

172 


54 

111 


54 

111 


61 

126 


57 

172 


57 


A# 


61 


172 126 


64 

188 


68 

149 


64 

188 


64 


68 

149 


68 


188 149 


C# 

72 

169 

72 

169 

~72 

69 


QUEN CY ^ SeS ' there are 2 settln 9s for each voice, a HIGH FRE- 

you mul p e oKE 9 , ™ENCY setting. To play a musical note, 

you must POKE a value into the HIGH FREQUENCY location and POKE 

another value into the LOW FREQUENCY location. Using the settinas in 
our VOICE/FREQUENCY/NOTE VAIUE .able, W. p lo " 

a C note from the 5th octave (VOICE 1): Y 

POKE 54273,34.POKE 54272,75. 

The same note on VOICE2 would be: 


POKE 54280,34:POKE 54279,75. 


Used in a program, it looks like this: 


5 FORL—54272TO54296:POKEL,0:NEXT 

10 V = 54296:W=54276:A=54277: < - 

S = 542 78: H =54273: L=54272 

20 POKEV, 15:POKEA, 190:POKES,89 «- 

30 POKEH,34:POKEL,75 <—- 

40 POKEW,33:FORT = 1TO200:NEXT<_ 

50 POKEW,32 <__ 


Set numbers equal to letters. 


POKE volume, waveform, attack/decay. 
POKE hi/lo freq. notes 
-start note, let it play 
. stop note 
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PLAYING A SONG ON THE COMMODORE 64 


The following program can be used to compose or play a song (using 
VOICE!). There are two important lessons in this program: First, note 
how we abbreviate all the long control numbers in the first line of the 
program . . . after that, we can use the letter W for "Waveform" instead 
of the number 54276. 

The second lesson concerns the way we use the DATA. This program 
is set up to let you enter 3 numbers for each note: the HIGH FREQUENCY 
NOTE VALUE, the LOW FREQUENCY NOTE VALUE, and the DURATION 
THE NOTE WILL BE PLAYED. 

For this song, we used a duration "count" of 125 for an eighth note, 
250 for a quarter note, 375 for a dotted quarter note, 500 for a half 
note and 1000 for a whole note. These number values can be increased 
or decreased to match a particular tempo, or your own musical taste. 

To see how a song gets entered, look at Line 100. We entered 34 
and 75 as our HIGH and LOW FREQUENCY settings to play a "C" note 
(from the sample scale shown previously) and then the number 250 for a 
quarter note. So the first note in our song is a quarter note C. The 
second note is also a quarter note, this time the note is "E" . . . and so 
on to the end of our tune. You can enter almost any song this way, 
adding as many DATA statement lines as you need. You can continue the 
note and duration numbers from one line to the next but each line must 
begin with the word DATA. DATA-1,-1,-1 should be the last line in your 
program. This line "ends" the song. 

Type the word NEW to erase your previous program and type in the 
following program, then type RUN to hear the song. 


MICHAEL ROW THE BOAT ASHORE-1 MEASURE 

2 FORL=54272TO54296:POKEL,0:NEXT 

5 V=54296:W=54276:A=54277:HF =54273:LF =54272:S=54278: 
PH=54275:PL=54274 

10 POKEV,15:POKEA,88:POKEPH,15:POKEPL / 15:POKES,89 
20 READH:IFH = — 1 THEN END 
30 READL 
40 READD 

60 POKEHF,F:POKELF,L:POKEW,65 
80 FORT = 1 TOD:NEXT:POKEW,64 
85 FORT = 1TO50:NEXT 
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WDDORE 64 
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5=54278: 


XES 39 



90 GOTO10 


120 DATA34, 75, 250, 43,52,250,5 1,97, 375,43,52 125 51 97 
125 DATA250,57,172,250 -94, .25,51,97 

110 DATA51,97,500,0,0,125,43,52,250,51,97,250,57 172 
115 DATA 1000,51,97,500 
120 DATA- 1,-1,-1 







CREATING SOUND EFFECTS 

Unlike music, sound effects are more often tied to a specific pro¬ 
gramming "action" such as the explosion made by an astro-fighter as it 
crashes through a barrier in a space game ... or the warning buzzer in 

a business program that tells the user he's about to erase his disk by 
mistake. y 

You have a wide range of options available if you want to create 
i erent sound effects. Here are 10 programming ideas which might 
help you get started experimenting with sound effects- 

>. Change the volume while a note is playing, for example to create 
an echo" effect. 

2. Vary between two notes rapidly to create a sound "tremor." 

3. Waveform ... try different settings for each voice. 

4. Attack/Decay ... to alter the rate a sound rises toward its "peak" 
volume and rate it diminishes from that peak. 

5. Sustain/Release ... to change sustain to volume of a sound effect 
and rate it diminishes from that volume. 

6. Multivoice effects . . . playing more than one voice at the same 
time, each voice independently controlled, or one voice playing 
longer or shorter than another, or serving as an "echo" or response 
to a first note. 

7. Changing notes on the scale, or changing octaves, using the values 
in the MUSICAL NOTE VALUE table. 

8. Use the Square Waveform and different Pulse Settings to create 
different effects. 

9. Use the Noise Waveform to generate "white noise" for accenting 
tonal sound effects or creating explosions, gunshots or footsteps 
The same musical notes that create music can also be used with the 
Noise Waveform to create different types of white noise 

10. Combine several HIGH/LOW frequencies in rapid succession across 
different octaves. 

11. Filter ... try the extra POKE setting in Appendix M. 
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SAMPLE SOUND EFFECTS TO TRY 


The following programs may be added to almost any BASIC program. 
They are included to give you some programming ideas and demon¬ 
strate the Commodore 64's sound effect range. 

Notice the programming shortcut we're using in Line 10. We can 
abbreviate those long cumbersome sound setting numbers by defining 
them as easy-to-use letters (numeric variables). Line 10 simply means 
that these easy to remember LETTERS can be used instead of those long 
numbers. Here, V = Volume, W—Waveform, A—Attack/Decay, H = High 
Frequency (VOICE1), and L=Low Frequency (VOICED. We then use these 
letters instead of numbers in our program . . . making our program 
shorter, typing faster, and the sound settings easier to remember and 
spot. 

DOLL CRYING 

10 V=54296: W=54276: A = 54277: H = 54273:L=54272 
20 POKEV, 15:POKEW,65:POKEA, 15 
30 FORX = 200TO5STEP-2:POKEH,40:POKEL,X:NEXT 
40 FORX= 150TO5STEP-2:POKEH,40:POKEL,X:NEXT 
50 POKEW,0 


SHOOTING SOUND . . . USING VOICE 1, NOISE WAVEFORM, FADING 
VOLUME 

10 V=54296:W=54276:A=54277:H =54273:L=54272 
20 FORX= 15TO0STEP-1 :POKEV,X:POKEW, 129:POKEA, 

15: POKE H,40: POKE L, 200: NEXT 
30 POKEW,0:POKEA,0 
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READ AND DATA 

You've seen how to assign values to variables directly within the pro¬ 
gram (A = 2), and how to assign different values while the program is 
running—through the INPUT statement. 

There are many times, though, when neither one of these ways will 
quite fit the job you're trying to do, especially if it involves a lot of 
information. 

Try this short program: 


18 REHO X 

28 PRINT 

“X IS NOW : "; X 

30 GOT0 1£ 


40 ORTH I., 

34 „ 10 ,j, 16 r 234 - 56 

RUN 

X IS NOW 

1 

X IS. NOW 

34 

X IS NOW 

10.5 

X IS NOW 

16 

X IS NOW 

234.56 

■'OUT OF DOTH ERROR IN 10 

READY 

■ 






In line 10, the computer READs one value from the DATA statement 
and assigns that value to X. Each time through the loop the next value in 
the DATA statement is read and that value assigned to X, and PRINTed. 
A pointer in the computer itself keeps track of which value is to be used 
next: 

Pointer 

1 

40 DATA 1, 34, 10.5, 16, 234.56 

When all the values have been used, and the computer executed the 
loop again, looking for another value, the OUT OF DATA error was dis¬ 
played because there were no more values to READ. 
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It is important to follow the format of the DATA statement precisely: 
40 DATA 1, 34, 10.5, 16, 234.56 

t t 

Comma separates No Comma 

each item 


: ~e c* these ways will 
* * evolves a lot of 



: ~ DATA statement 
occ ~~e r ex+ value in 
red *o-X, and PRINTed. 
- c~ - o _e s to be used 


comp-wter executed the 
C* DATA e rr or was dis- 



Data statements can contain integer numbers, real numbers (234.65), 
or numbers expressed in scientific notation. But you can't READ other 
variables, or have arithmetic operations in DATA lines. This would be 
incorrect: 

40 DATA A, 23/56, 2*5 

You can, however, use a string variable in a READ statement and then 
place string information in the DATA line. The following is acceptable: 


NEW 

10 FOR X = 1 to 3 
15 READ AT 

20 PRINT "At IS NOW : "; 
30 NEXT 

40 DATA THIS, IS, FUN 
RUN 

At IS NOW : THIS 
AT IS NOW : IS 
A# IS NOW : FUN 
READY 


Notice that this time, the READ statement was placed inside a FOR 
. . . NEXT loop. This loop was then executed to match the number of 
values in the data statement. 

In many cases you will change the number of values in the DATA 
statement each time the program is run. A way to avoid counting the 
number of values and still avoid an OUT OF DATA ERROR is to place a 
"FLAG" as the last value in the DATA line. This would be a value that 
your data would never equal, such as a negative number or a very 
large or small number. When that value is READ the program will 
branch to the next part. 

There is a way to reuse the same DATA later in the program by RE- 
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STOREing the data pointer to the beginning of the data list. Add line 50 
to the previous program: 

50 GOTO 10 

You will still get the OUT OF DATA error because as the program 
branches back to line 10 to reread the data, the data pointer indicates 
all the data has been used. Now, add: 

45 RESTORE 

and RUN the program again. The data pointer has been RESTOREd and 
the data can be READ continuously. 

AVERAGES 

The following program illustrates a practical use of READ and DATA, 
by reading in a set of numbers and calculating their average. 


NEW 

5 T = y : CT = 0 
10 RE HD t< 

20 IF X = -1 THEN 50: REM CHECK FOR FLAG 

2*=. CT = CT + 1 

30 T = T + K■s REM UPDATE TOTAL 
40 AGIO 10 

50 PRINT "THERE WERE CT;"VALUES READ" 

60 PRINT "TOTfiL = ":T 

70 PRINT "AVERHOE T.'cT 

80 DRTfi 75, 80, 62, 91, 87, 93, 78, -1 


RUN 

THERE WERE 7 VALUES READ 

TOTAL = 566 

AVERAGE = 80.8571429 


Line 5 sets CT, the CounTer, and T, Total, equal to zero. Line 10 READs 
a value and assigns the value to X. Line 20 checks to see if the value is 
our flag (here a -1). If the value READ is part of the valid DATA, CT is 
incremented by 1 and X is added to the total. 

When the flag is READ, the program branches to line 50 which PRINTS 
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the number of values read. Line 60 PRINTs the total, and line 70 divides 
the total by the number of values to get the average. 

By using a flag at the end of the DATA, you can place any number of 

values in DATA statements—which may stretch over several lines_ 

without worrying about counting the number of values entered. 

Another variation of the READ statement involves assigning informa¬ 
tion from the same DATA line to different variables. This information can 
even be a mixture of string data and numeric values. You can do all this 
in the following program that will READ a name, some scores—say 
bowling—and print the name, scores, and the average score: 


NEW 

■ •-> 

10 READ N$.R,R.C 

20 PRINT N$;"'S SCOPES WERE: 
SO PRINT "AND THE AVERAGE IS 
40 PRINT: GOTO 10 

50 DOTH HIKE. ISO, 185, 165, 
60 DATA JOHN, 155, 185, 205. 

" : H ? " '' r B : " " ■ f: 

: "; 'R+B+C > ,73 

DICK. .225., 245, 190 
F'HUL , 160 r 1 79 r 1 37 

RUN 


HIKE 'S SCORES: WERE: 190 185 

HND THE AVERAGE IS : ISO 

165 

DICK'S SCORES WERE: 225 245 

HND THE AVERAGE IS : 220 

190 



In running the program, the DATA statements were set up in the same 
order that the READ statement expected the information: a name (a 
string), then three values. In other words N$ the first time through gets 
the DATA "MIKE", A in the READ corresponds to 190 in the data state¬ 
ment, B to 185 and "C" to 165. The process is then repeated in that 
order for the remainder of the information. (Dick and his scores, John 
and his scores, and Paul and his scores.) 



SUBSCRIPTED VARIABLES 

In the past we've used only simple BASIC variables, such as A, A$, 
and NU to represent values. These were a single letter followed by a 
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letter or single digit. In any of the programs that you would write, it is 
doubtful that we would have a need for more variable names than 
possible with all the combinations of letters or numbers available. But 
you are limited in the way variables are used with programs. 

Now let's introduce the concept of subscripted variables. 


A(l) 


- Subscript 

- Variable 


This would be said: A sub 1. A subscripted variable consists of a letter 
followed by a subscript enclosed within parentheses. Please note the 
difference between A, Al, and A(l). Each is unique. Only A(l) is a 
subscripted variable. 

Subscripted variables, like simple variables, name a memory location 
within the computer. Think of subscripted variables as boxes to store 
information, just like simple variables: 



If you wrote: 

10 A(p) = 25: A(3) = 55 : A(4) = -45.3 

Then memory would look like this: 

A(0) 

A(l) 

A(2) 

A(3) 

A(4) 

This group of subscripted variables is also called an array. In this 
case, a one-dimensional array. Later on, we'll introduce multidimen¬ 
sional arrays. 

Subscripts can also be more complex to include other variables, or 
computations. The following are valid subscripted variables: 

A(X) A(X+1) A(2+l) A(l*3) 

The expressions within the parentheses are evaluated according to the 
same rules for arithmetic operations outlined in Chapter 2. 


25 


55_ 

-45.3 



Now that the ground r ~ es are ~ 
ab es be put to use? Ore wa* s to slc^e : 
NPUT or READ statements, 
le* s use subscripted vc r cc es *z dc —- 


5 PRINT CHW* 147- 

lu input -hgm many hungers 

2© FOP A = 1 TO X 
30 PRINT “ENTER VALUE # 

40 NEXT 
50 SU = O 
60 FO R H - 1 TO X 
7© SU = SU + H * 

SO NEXT 

90 PRINT : PRINT "AVEBnPjE - 


RUN 


HOW MhHV numbers 

2 - 

v CT 

ENTER 

VALUE # 

1 


125 

ENTER 

VAL UE # 


--> 

167 

ENTER 

VALUE # 

-> 

- 

109 

ENTER 

VALUE # 

4 

'y 

167 

ENTER 

VALUE # 

S 

•> 

153 


AVERAGE = 161 - 2 
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Now that the ground rules are in place, how can subscripted vari¬ 
ables be put to use? One way is to store a list of numbers entered with 
INPUT or READ statements. 

Let's use subscripted variables to do the averages a different way. 


5 PRINT CHRf v 147 


10 INPUT "HOW flRHV NUMBERS :" ;X 

20 FOR h = 1 TO : 


30 PRINT "ENTER ' 
40 NEXT 
*50 SU - 0 

v'HLiJE # "rH;:INPUT EKR.> 

69 FOR H = 1 TO J 


70 SU ~ SU + BCR 
SO NEXT 

> 

90 PRINT : PRINT 

"HVERHGE ~ -SU/X 

RUN 


HOW MhNV NUMBERS 

„ ■ -» cr 

ENTER VALUE # 1 

? 125 . 

ENTER VALUE # 2 

? 167 

ENTER VALUE #' 3 

? 189 

ENTER VALUE # 4 

? 167 

ENTER VALUE # 5 

? 158 

AVERAGE — 1G1.2 



There might have been an easier way to accomplish what we did in 
this program, but it illustrates how subscripted variables work. Line 10 
asks for how many numbers will be entered. This variable, X, acts as 
the counter for the loop within which values are entered and assigned to 
the subscripted variable, B. 

Each time through the INPUT loop, A is increased by 1 and so the next 
value entered is assigned to the next element in the array A. For exam¬ 
ple, the first time through the loop A = 1, so the first value entered 
is assigned to B(l). The next time through, A = 2; the next value is 
assigned to B(2), and so on until all the values have been entered. 

But now a big difference comes into play. Once all the values have 
been entered, they are stored in the array, ready to be put to work in a 
variety of ways. Before, you kept a running total each time through the 
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INPUT or READ loop, but never could get back the individual pieces of 
data without re-reading the information. 

In lines 50 through 80, another loop has been designed to add up the 
various elements of the array and then display the average. This sepa¬ 
rate part of the program shows that all of the values are stored and can 
be accessed as needed. 

To prove that all of the individual values are actually stored separately 
in an array, type the following immediately after running the previous 
program: 

FOR A = 1 TO 5 : ?B(A),: NEXT 

125 167 189 167 

158 

The display will show your actual values as the contents of the array 
are PRINTed. 


DIMENSION 

If you tried to enter more than 10 numbers in the previous example, 
you got a DIMENSION ERROR. Arrays of up to eleven elements (sub¬ 
scripts 0 to 10 for a one-dimensional array) may be used where needed, 
just as simple variables can be used anywhere within a program. Arrays 
of more than eleven elements need to be "declared" in a dimension 
statement. 

Add this line to the program: 

5 DIM B(100) 

This lets the computer know that you will have a maximum of 100 
elements in the array. 

The dimension statement may also be used with a variable, so the 
following line could replace line 5 (don't forget to eliminate line 5): 

15 DIM B(X) 

This would dimension the array with the exact number of values that 
will be entered. 

Be careful, though. Once dimensioned, an array cannot be redimen¬ 
sioned in another part of the program. You can, however, have multiple 
arrays within the program and dimension them all on the same line, like 
this: 

10 DIM C(20), D(50), E(40) 
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SIMULATED DICE ROLL WITH ARRAYS 

As programs become more complex, using subscripted variables will 
cut down on the number of statements needed, and make the program 
simpler to write. 

A single subscripted variable can be used, for example, to keep track 
of the number of times a particular face turns up: 

1 REM DICE SIMULATION : PRINT CHR$<147> 

10 INPUT "HOW MRNV ROLLS:";X 
20 FOR L = 1 TO X 
30 R = INT<6*RND<1>>+1 
40 F<R> = F<R> + 1 
50 NEXT L 

60 PRINT "FRCE", "NUMBER OF TIMES” 

70 FOR C = 1 TO 6 : PRINT C, F<C>s NEXT 

The array F, for FACE, will be used to keep track of how many times a 
particular face turns up. For example, every time a 2 is thrown, F(2) is 
increased by one. By using the same element of the array to hold the 
actual number on the face that is thrown, we've eliminated the need for 
five other variables (one for each face) and numerous statements to 
check and see what number is thrown. 

Line 10 asks for how many rolls you want to simulate. 

Line 20 establishes the loop to perform the random roll and increment 
the proper element of the array by one each for each toss. 

After all of the required tosses are completed, line 60 PRINTs the 
heading and line 70 PRINTs the number of times each face shows up. 

A sample run might look like this: 


HOW MRNV ROLLS: 

? 100O 

FRCE 

NUMBER OF TIMES 

1 

148 

-■> 

176 

o 

178 

4 

166 

5 

163 

s 

169 


Well, at least it wasn't loaded! 

Just as a comparison, the following is one way of re-writing the same 
program, but without using subscripted variables. Don't bother to type it 
in, but do notice the additional statements necessary. 
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10 INPUT "HOW MRNV ROLLS: M ;X 
28 FOR L = 1 TO X 
30 R = INT<6*RND<1>>+1 


40 

IF 

R = 

1 

THEN 

FI 

= 

FI 

+ 

1 

NEXT 

41 

IF 

R = 

2 

THEN 

F2 

= 

F2 

+ 

1 

NEXT 

42 

IF 

R = 

3 

THEN 

F3 

= 

F3 

+ 

1 

NEXT 

43 

IF 

R = 

4 

THEN 

F4 

= 

F4 

+ 

1 

NEXT 

44 

IF 

R = 

5 

THEN 

F5 

= 

F5 

+ 

1 

NEXT 

45 

IF 

R = 

6 

THEN 

F6 

= 

F6 

+ 

1 

NEXT 

60 

PRINT 

"FRCE", 

"NUMBER 

OF 

TIMES" 


70 PRINT 1, FI 

71 PRINT 2, F2 

72 PRINT 3 , F3 

73 PRINT 4 ? F4 

74 PRINT 5.r F5 

75 PRINT 6, F6 


The program has doubled in size from 8 to 16 lines. In larger pro¬ 
grams the space savings from using subscripted variables will be even 
more dramatic. 


TWO-DIMENSIONAL ARRAYS 

Earlier in this chapter you experimented with one-dimensional arrays. 
This type of array was visualized as a group of consecutive boxes within 
memory each holding an element of the array. What would you expect 
a two-dimensional array to look like? 

First, a two-dimensional array would be written like this: 

A(4,6) 

SUBSCRIPTS 
ARRAY NAME 

and could be represented as a two-dimensional grid within memory: 


0 

1 

2 

3 

4 

The subscripts could be thought of as representing the row and col¬ 
umn within the table where the particular element of the array is stored. 
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A(3,4) = 255 

t t_ COLUMN 


i _ ] _ 2 3 4 5 6 



























255 











If we assigned the value 255 to A(3,4), then 255 could be thought of 
as being placed in the 4th column of the 3rd row within the table. 

Two-dimensional arrays behave according to the same rules that were 
established for one-dimensional arrays: 


They must be dimensioned: 
Assignment of data: 

Assign values to other variables: 
PRINT values: 


DIM A(20,20) 
A(1,1) = 255 
AB = A( 1,1) 
PRINT A(1,1) 


If two-dimensional arrays work like their smaller counterparts, what 
additional capabilities will the expanded arrays handle? 

Try this: can you think of a way using a two-dimensional array to 
tabulate the results of a questionnaire for your club that involved four 
questions and had up to three responses for each question? The prob¬ 
lem could be represented like this: 


CLUB QUESTIONNAIRE 
Ql: ARE YOU IN FAVOR OF RESOLUTION #1? 
□ l-YES D2-NO D3-UNDECIDED 


. . . and so on. 
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The array table for this problem could be represented like this: 

responses 

UNDECIDED 


YES 


RESPONSES 

NO 


QUESTION 1 
QUESTION 2 
QUESTION 3 
QUESTION 4 


The program to do the actual tabulation for the questionnaire might 
look like that shown on page 103. 

This program makes use of many of the programmmg techniques that 
have been presented so far. Even if you don't have any need for the 
actual program right now, see if you can follow how the program 

W °The heart of this program is a 4 by 3 two-dimensional array, A(4 3). 
The total responses for each possible answer to each question are held 
in the appropriate element of the array. For the sake of Simplicity, we 
don't use the first rows and column (A(0,0) to A(0,4)). Remember, 
though, that those elements are always present in any array you de».gn- 
In practice, if question one is answered YES, Then Ad,D i 
cremented by one —row 1 for question 1 and column 1 for a YES re¬ 
sponse. The rest of the questions and answers follow the same patterm 
A NO response for question three would add one to element A(3,2), and 

so on. 
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20 PRINT "{CLR/HOME}" 

30 FOR R = 1 TO 4 

40 PRINT "QUESTION # : "; R 

50 PRINT " 1-VES 2-NO 3—UNDECIDED" 

60 PRINT "WHAT WRS THE RESPONSE : "; 

61 GET C : IF C <1 or 03 THEN 61 
65 PRINT C: PRINT 

70 FKR,C> = A<R,C> + 1: REM UPDATE ELEMENT 
80 NEXT R 
85 PRINT 

90 PRINT "DO VOU WANT TO ENTER ANOTHER": PRINT 
"RESPONSE <V/N>"; 

100 GET A$ : IF At = "" THEN 100 
*10 IF A# = "V" THEN 20 
120 IF A# O "N" THEN 100 

130 PRINT "{CLR/HOME}";"THE TOTAL RESPONSES 
WERE:":PRINT 

140 PRINT SPC<18>;"RESPONSE" 

141 PRINT "QUESTION","VES","NO","UNDECIDED" 


14? PR T NT " — 

0 




150 FOR R = 

1 TO 4 




160 PRINT R, 

A<R,1>, A < R , 2 > 

, R<R,3> 



170 NEXT R 
RUN 





QUESTION # °s 

1 




1-VES 2-NO 

3-UNDECIDED 




WHfiT WRS THE 

RESPONSE : 1 




QUESTION # s 

2 




1-VES 2-NO 

3-UNDECIDED 




WHftT WRS THE 

RESPONSE s 1 




Rnd so on... 

. ’ ■; ' ■ '/ o 




THE TOTRL RESPONSES WERE: 





RESPONSE 




VES 

Bit.——1 



i 

6 

1 

0 


2 

5 

2 

0 


3 

7 

0 

0 


4 

2 

o 

4 

1° 
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INTRODUCTION 

Now that you've become more intimately involved with your Commo¬ 
dore 64, we want you to know that our customer support does not stop 
here. You may not know it, but Commodore has been in business for 
over 23 years. In the 1970's we introduced the first self-contained per¬ 
sonal computer (the PET). We have since become the leading computer 
company in many countries of the world. Our ability to design and 
manufacture our own computer chips allows us to bring you new and 
better personal computers at prices way below what you'd expect for 
this level of technical excellence. 

Commodore is committed to supporting not only you, the end user, 
but also the dealer you bought your computer from, magazines which 
publish how-to articles showing you new applications or techniques, 
and . . . importantly . . . software developers who produce programs 
on cartridge, disk and tape for use with your computer. We encourage 
you to establish or join a Commodore "user club" where you can learn 
new techniques, exchange ideas and share discoveries. We publish two 
separate magazines which contain programming tips, information on 
new products and ideas for computer applications. (See Appendix N). 

In North America, Commodore provides a "Commodore Information 
Network" on the CompuServe Information Service ... to access this 
network, all you need is your Commodore 64 computer and our low cost 
VICMODEM telephone interface cartridge (or other compatible modem). 

The following APPENDICES contain charts, tables, and other informa¬ 
tion which help you program your Commodore 64 faster and more 
efficiently. They also include important information on the wide variety 
of Commodore products you may be interested in, and a bibliography 
listing of over 20 books and magazines which can help you develop your 
programming skills and keep you current on the latest information con¬ 
cerning your computer and peripherals. 
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COMMODORE 64 ACCESSORIES 
AND SOFTWARE 


ACCESSORIES 

The Commodore 64 will support Commodore VIC 20 storage devices 
and accessories DATASSETTE recorder, disk drive, modem, printer — 
so your system can expand to keep pace with changing needs. 

• Datasette Recorder—This low cost tape unit enables programs and 
data to be stored on cassette tape, and played back at a later 
time. The datasette can also be used to play pre-written programs. 

• Disk—The single disk unit uses standard 5 ’/ 4 -inch floppy diskettes, 
about the size of a 45 RPM record, to store programs and data. 
Disks allow faster access to data and hold up to 170,000 char¬ 
acters of information each. Disk units are "intelligent," meaning 
they have their own microprocessor and memory. Disks require no 
resources from the Commodore 64, such as using part of main 
memory. 

• Modem—A low-cost communication device,the VICMODEM allows 
access to other computers over ordinary telephone lines. Users will 
have access to the full resources of large data bases such as The 
Source, CompuServe, and Dow Jones News Retrieval Service (North 
America only). 

• Printer The VIC printer produces printed copies of programs, 
data, or graphics. This 30 character per second dot-matrix printer 
uses plain tractor feed paper and other inexpensive supplies. The 
printer attaches directly to the Commodore 64 without any addi¬ 
tional interfaces. 

• Interface Cartridges—A number of specialized cartridges will be 
available for the Commodore 64 to allow various standard devices 
such as modems, printers, controllers, and instruments to be at¬ 
tached to the system. 
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With a special IEEE-488 Cartridge, the Commodore 64 will support 
the full range of CBM peripherals including disk units and printers. 

Additionally, a Z80 cartridge will allow you to run CP/M* on the 
Commodore 64, giving you access to the largest base of 
microcomputer applications available. 


SOFTWARE 

Several categories of software will be offered for the Commodore 64, 
providing you with a wide variety of personal, entertainment, and edu¬ 
cational applications to choose from. 



BUSINESS AIDS 

• An Electronic Spreadsheet package will allow you to plan budgets, 
and perform "what if?" analysis. And with the optional graphic 
program, meaningful graphs may be created from the spreadsheet 
data. 

• Financial planning, such as loan amortization, will be easily han¬ 
dled with the Financial Planning Package. 

• A number of Professional Time Management programs will help 
manage appointments and work load. 

• Easy-to-use Data Base programs will allow you to keep track of 
information . . . mailing lists . . . phone lists . . . inventories . . . 
and organize information in a useful form. 

• Professional Word Processing programs will turn the Commodore 64 
into a full-featured word processor. Typing and revising memos, 
letters, and other text material become a breeze. 



ENTERTAINMENT 

• The highest quality games will be available on plug-in cartridges 
for the Commodore 64, providing hours of enjoyment. These pro¬ 
grams make use of the high resolution graphics and full sound 
range possible with the Commodore 64. 

• Your Commodore 64 allows you all the fun and excitement avail¬ 
able on MAX games because these two machines have completely 
compatible cartridges. 



*CP/M is a registered trademark of Digital Research Inc. 
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• The Commodore 64 is a tutor that never tires and always gives 
personal attention. Besides access to much of the vast PET educa¬ 
tional programs, additional educational languages that will be 
available for the Commodore 64 include PILOT, LOGO and other 
key advanced packages. 
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APPENDIX B 


ADVANCED CASSETTE OPERATION 


Besides saving copies of your programs on tape, the Commodore 64 
can also store the values of variables and other items of data, in a 
group called a FILE. This allows you to store even more information than 
could be held in the computer's main memory at one time. 

Statements used with data files are OPEN, CLOSE, PRINT#, INPUT#, 
and GET#. The system variable ST (status) is used to check for tape 
markers. 

In writing data to tape, the same concepts are used as when display¬ 
ing information on the computer's screen. But instead of PRINTing in¬ 
formation on the screen, the information is PRINTed on tape using a 
variation of the PRINT command — PRINT#. 

The following program illustrates how this works: 


10 PRINT "NRITE-TQ-TAPE—PROGRAM" 

20 OPEN 1,1r1r"DRTR FILE" 

30 PRINT "TYPE DRTR TO BE STORED UR TYPE STOP" 
50 PRINT 

60 INPUT "DRTR";R$ 

70 PRINT #1, R$ 

80 IF fi$ O"ST0P" THEN 50 
90 PRINT 

100 PRINT "CLOSING FILE" 

110 CLOSE 1 


The first thing that you must do is OPEN a file (in this case DATA FILE). 
Line 10 handles that. 

The program prompts for the data you want to save on tape in line 
60. Line 70 writes what you typed — held in A$—onto the tape. And the 
process continues. 

If you type STOP, line 110 CLOSES the file. 


no 






To retrieve the information, rewind the tape, and try this: 


10 PRINT "RERD-TRPE-PROGRRM" 
20 OPEN l.,l, 0 , " DRTR FILE" 

30 PRINT "FILE OPEN" 

40 PRINT 

■50 INPUT#l r R$ 

60 PRINT R* 

70 IF R$ = "STOP" THEN END 
80 GOTO 40 


Again, the file "DATA FILE" first must be OPENed. In line 50 the pro¬ 
gram INPUTs A$ from tape and also PRINTs A$ on the screen. Then the 
whole process is repeated until "STOP" is found, which ENDs the pro¬ 
gram. 

A variation of GET — GET#—can also be used to read the data back 
from tape. Replace lines 50-80 in the program above with: 


50 GET# 1 .r R$ 

60 IF R$ = l,M THEN END 
70 PRINT R$.. RSCCR*} 

80 GOTO 50 









APPENDIX C 


COMMODORE 64 BASIC 


This manual has given you an introduction to the BASIC language — 
enough for you to get a feel for computer programming and some of 
the vocabulary involved. This appendix gives a complete list of the rules 
(SYNTAX) of Commodore 64 BASIC, along with concise descriptions. 
Please experiment with these commands. Remember, you can't do any 
permanent damage to the computer by just typing in programs, and the 
best way to learn computing is by doing. 

This appendix is divided into sections according to the different types 
of operations in BASIC. These include: 

1. Variables and Operators: describes the different type of variables, 
legal variable names, and arithmetic and logical operators. 

2. Commands: describes the commands used to work with programs, 
edit, store, and erase them. 

3. Statements: describes the BASIC program statements used in num¬ 
bered lines of programs. 

4. Functions: describes the string, numeric, and print functions. 

VARIABLES 

The Commodore 64 uses three types of variables in BASIC. These are 
real numeric, integer numeric, and string (alphanumeric) variables. 

Variable names may consist of a single letter, a letter followed by a 
number, or two letters. 

An integer variable is specified by using the percent (%) sign after the 
variable name. String variables have the dollar sign ($) after their 
name. 

EXAMPLES 

Real Variable Names: A, A5, BZ 
Integer Variable Names: A%, A5%, BZ% 
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String Variable Names: A$, A5$, BZ$ 

Arrays are lists of variables with the same name, using extra numbers 
to specify the element of the array. Arrays are defined using the DIM 
statement, and may contain floating point, integer, or string variables. 
The array variable name is followed by a set of parentheses ( ) enclos¬ 

ing the number of variables in the list. 

A(7), BZ%(11), A$(50), PT(20,20) 

NOTE: There are three variable names which are reserved for use by 
the Commodore 64, and may not be defined by you. These variables 
are: Sf, Tl, and Tl$. ST is a status variable which relates to input/output 
operations. The value of ST will change if there is a problem loading a 
program from disk or tape. 

Tl and Tl$ are variables which relate to the real-time clock built into 
the Commodore 64. The variable Tl is updated every V 60 th of a second. 
It starts at 0 when the computer is turned on, and is reset only by chang¬ 
ing the value of Tl$. 

Tl$ is a string which is constantly updated by the system. The first two 
characters contain the number of hours, the 3rd and 4th characters the 
number of minutes, and the 5th and 6th characters are the number of 
seconds. This variable can be given any numeric value, and will be 
updated from that point. 

Tl$ = "101530" sets the clock to 10:15 and 30 seconds AM. 

This clock is erased when the computer is turned off, and starts at 
zero when the system is turned back on. 


ASIC. These are 
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OPERATORS 

The arithmetic operators include the following signs: 

+ Addition 
— Subtraction 
* Multiplication 
/ Division 

j Raising to a power (exponentiation) 

On a line containing more than one operator, there is a set order in 
which operations always occur. If several operations are used together 
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on the same line, the computer assigns priorities as follows: First, ex¬ 
ponentiation. Next, multiplication and division, and last, addition and 
subtraction. 

You can change the order of operations by enclosing within pa¬ 
rentheses the calculation to be performed first. Operations enclosed in 
parentheses will take place before other operations. 

There are also operations for equalities and inequalities: 

= Equal To 

< Less Than 

> Greater Than 
<= Less Than or Equal To 
>= Greater Than or Equal To 
<> Not Equal To 

Finally, there are three logical operators: 

AND 

OR 

NOT 

These are used most often to join multiple formulas in IF . . . THEN 
statements. For example: 

IF A = B AND C = D THEN 100 (Requires both parts to be true) 

IF A = B OR C = D THEN 100 (Allows either part to be true) 


COMMANDS 

CONT (Continue) 

This command is used to restart the execution of a program which has 
been stopped by either using the STOP key, a STOP statement, or an 
END statement within the program. The program will restart at the exact 
place from where it left off. 

CONT will not work if you have changed or added lines to the pro¬ 
gram (or even just moved the cursor), or if the program halted due to an 
error, or if you caused an error before trying to restart the program. In 
these cases you will get a CAN'T CONTINUE ERROR. 
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LIST 


The LIST command allows you to look at lines of a BASIC program in 
memory. You can ask for the entire program to be displayed, or only 
certain line numbers. 

Shows entire program 
Shows only from line 10 until end 
Shows only line 10 
Shows lines from beginning until 10 
Shows line from 10 to 20, inclusive 


LIST 

LIST 10- 
LIST 10 
LIST -10 
LIST 10-20 


LOAD 


This command is used to transfer a program from tape or disk into 
memory so the program can be used. If you just type LOAD and hit 
RETURN, the first program found on the cassette unit will be placed in 
memory. The command may be followed by a program name enclosed 
within quotes. The name may then be followed by a comma and a 
number or numeric variable, which acts as a device number to indicate 
where the program is coming from. 

If no device number is given, the Commodore 64 assumes device #1, 
which is the cassette unit. The other device commonly used with the 
LOAD command is the disk drive, which is device #8. 


LOAD 

LOAD "HELLO" 

LOAD A$ 

LOAD "HELLO",8 
LOAD "*",8 


Reads in the next program on tape 
Searches tape for program called 
HELLO, and loads program, if found 
Looks for program whose name is in the variable A$ 
Looks for program called HELLO on the disk drive 
Looks for first program on disk 


NEW 


This command erases the entire program in memory, and also clears 
out any variables that may have been used. Unless the program was 
SAVEd, it is lost. BE CAREFUL WHEN YOU USE THIS COMMAND. 

The NEW command can also be used as a BASIC program statement. 
When the program reaches this line, the program is erased. This is use¬ 
ful if you want to leave everything neat when the program is done. 
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RUN 


This command causes execution of a program, once the program is 
loaded into memory. If there is no line number following RUN, the com¬ 
puter will start with the lowest line number. If a line number is desig¬ 
nated, the program will start executing from the specified line. 


RUN 

RUN 100 
RUN X 


Starts program at lowest line number 
Starts execution at line 100 
UNDEFINED STATEMENT ERROR. You must 
always specify an actual line number, 
not a variable representation 


SAVE 


This command will store the program currently in memory on cassette 
or disk. If you just type SAVE and RETURN, the program will be SAVEd on 
cassette. The computer has no way of knowing if there is a program 
already on that tape, so be careful with your tapes or you may erase a 
valuable program. 

If you type SAVE followed by a name in quotes or a string variable, 
the computer will give the program that name, so it can be more easily 
located and retrieved in the future. The name may also be followed by 
a device number. 

After the device number, there can be a comma and a second 
number, either 0 or 1. If the second number is 1, the Commodore 64 will 
put an END-OF-TAPE marker after your program. This signals the 
computer not to look any further on the tape if you were to give an 
additional LOAD command. If you try to LOAD a program and the com¬ 
puter finds one of these markers, you will get a FILE NOT FOUND ER¬ 
ROR. 


SAVE 

SAVE "HELLO" 
SAVE A$ 

SAVE "HELLO",8 
SAVE "HELLO", 1,1 


Stores program to tape without name 
Stores on tape with name HELLO 
Stores on tape with name in A$ 

Stores on disk with name HELLO 
Stores on tape with name HELLO 
and follows program with END-OF- 
TAPE marker 
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VERIFY 


This command causes the computer to check the program on disk or 
tape against the one in memory. This is proof that the program is actu¬ 
ally SAVEd, in case the tape or disk is bad, or something went wrong 
during the SAVE. VERIFY without anything after the command causes the 
Commodore 64 to check the next program on tape, regardless of name, 
against the program in memory. 

VERIFY followed by a program name, or a string variable, will search 
for that program and then check. Device numbers can also be included 
with the verify command. 

VERIFY Checks the next program on tape 

VERIFY "HELLO" Searches for HELLO, checks against memory 

VERIFY "HELLO",8 Searches for HELLO on disk, then checks 


STATEMENTS 

CLOSE 

This command completes and closes any files used by OPEN state¬ 
ments. The number following CLOSE is the file number to be closed. 

CLOSE 2 Only file #2 is closed 

CLR 

This command will erase any variables in memory, but leaves the 
program itself intact. This command is automatically executed when a 
RUN command is given. 

CMD 

CMD sends the output which normally would go to the screen (i.e., 
PRINT statements, LISTs, but not POKEs onto the screen) to another de¬ 
vice instead. This could be a printer, or a data file on tape or disk. This 
device or file must be OPENed first. The CMD command must be fol¬ 
lowed by a number or numeric variable referring to the file. 
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OPEN 1,4 OPENs device #4, which is the printer 

CMD 1 All normal output now goes to printer 

LIST The program listing now goes to 

the printer, not the screen 

To send output back to the screen, CLOSE the file with CLOSE 1. 

DATA 

This statement is followed by a list of items to be used by READ 
statements. Items may be numeric values or text strings, and items are 
separated by commas. String items need not be inside quote marks 
unless they contain space, colon, or comma. If two commas have noth¬ 
ing between them, the value will be READ as a zero for a number, or an 
empty string. 

DATA 12, 14.5, "HELLO, MOM", 3.14, PARTI 

DEF FN 


This command allows you to define a complex calculation as a func¬ 
tion with a short name. In the case of a long formula that is used many 
times within the program, this can save time and space. 

The function name will be FN and any legal variable name (1 or 2 
characters long). First you must define the function using the statement 
DEF followed by the function name. Following the name is a set of pa¬ 
rentheses enclosing a numeric variable. Then follows the actual formula 
that you want to define, with the variable in the proper spot. You can 
then "call" the formula, substituting any number for the variable. 


10 DEF FNA(X) = 12*(34.75 - X/.3) 
20 PRINT FNA(7) 


t 


7 is inserted where 


X is in the formula 


For this example, the result would be 137. 


DIM 

When you use more than 11 elements of an array, you must execute a 
DIM statement for the array. Keep in mind that the whole array takes up 
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'oom in memory, so don't create an array much larger than you'll need 
o r, 9 ure the number of variables created with DIM, multiply the total 
number of elements in each dimension of the array. 

10 DIM A$(40), B7(15), CC%(4,4,4) 

t t f 

41 ELEMENTS 16 ELEMENTS 125 ELEMENTS 

You can dimension more than one array in a DIM statement. How¬ 
ever, be careful not to dimension an array more than once. 

END 

When a program encounters an END statement, the program halts, as 
if it ran out of lines. You may use CONT to restart the program. 

FOR. . .TO. . .STEP 

This statement works with the NEXT statement to repeat a section of 
the program a set number of times. The format is: 

FOR (Var. Name)=(Start of Count) TO (End of Count) STEP (Count By) 

The loop variable will be added to or subtracted from during the 
program. Without any STEP specified, STEP is assumed to be 1. The start 
count and end count are the limits to the value of the loop variable. 

10 FOR L = 1 TO 10 STEP .1 
20 PRINT L 
30 NEXT L 

The end of the loop value may be followed by the word STEP and 
another number or variable. In this case, the value following STEP is 

added each time instead of 1. This allows you to count backwards, or 
by fractions. 

GET 

The GET statement allows you to get data from the keyboard, one 
character at a time. When GET is executed, the character that is typed is 
assigned to the variable. If no character is typed, then a null (empty) 
character is assigned. 
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GET is followed by a variable name, usually a string variable. If a 
numeric variable was used and a nonnumeric key depressed, the pro¬ 
gram would halt with an error message. The GET statement may be 
placed into a loop, checking for any empty result. This loop will continue 
until a key is hit. 

10 GET A$: IF A$ = "" THEN 10 

GET# 

The GET# statement is used with a previously OPENed device or file, 
to input one character at a time from that device or file. 

GET # 1 ,A$ 

This would input one character from a data file. 

GOSUB 

This statement is similar to GOTO, except the computer remembers 
which program line it last executed before the GOSUB. When a line with 
a RETURN statement is encountered, the program jumps back to the 
statement immediately following the GOSUB. This is useful if there is a 
routine in your program that occurs in several parts of the program. 
Instead of typing the routine over and over, execute GOSUBs each time 
the routine is needed. 

20 GOSUB 800 

GOTO OR GO TO 

When a statement with the GOTO command is reached, the next line 
to be executed will be the one with the line number following the word 
GOTO. 

IF. . .THEN 

IF. . .THEN lets the computer analyze a situation and take two possi¬ 
ble courses of action, depending on the outcome. If the expression is 
true, the statement following THEN is executed. This may be any BASIC 
statement. 

If the expression is false, the program goes directly to the next line. 
The expression being evaluated may be a variable or formula, in 
which case it is considered true if nonzero, and false if zero. In most 
cases, there is an expression involving relational operators (=, <, >, 
< = , > = , <>, AND, OR, NOT). 
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INPUT 

ThS INPUT statement allows the program to get data from the user 
assigning that data to a variable. The program will stop, print a ques- 

mar (?) on the screen, and wait for the user to type in the answer 
and hit RETURN. 

INPUT is followed by a variable name, or a list of variable names, 
separated by commas. A message may be placed within quote marks! 
Before the list of variable names to be INPUT. If more than one variable 
is to be INPUT, they must be separated by commas when typed. 

10 INPUT "PLEASE ENTER YOUR FIRST NAME ",A$ 

20 PRINT ENTER YOUR CODE NUMBER"; : INPUT B 

INPUT# 


*5 ©r 


s a 


INPUT# is similar to INPUT, but takes data from a previously OPENed 
tile or device. 

10 INPUT#!, A 


LET 
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is hardly ever used in programs, since it is optional, but the 
statement is the heart of all BASIC programs. The variable name which 
■s to be assigned the result of a calculation is on the left side of the 
equal sign, and the formula on the right. 

1 0 LET A = 5 
20 LET D$ = "HELLO" 


NEXT 


NEXT is always used in conjunction with the FOR statement. When the 
program reaches a NEXT statement, it checks the FOR statement to see 
if the limit of the loop has been reached. If the loop is not finished, the 
loop variable is increased by the specified STEP value. If the loop is 
inished, execution proceeds with the statement following NEXT. 
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NEXT may be followed by a variable name, or list of variable names, 
separated by commas. If there are no names listed, the last loop started 
is the one being completed. If variables are given, they are completed 
in order from left to right. 

10 FOR X = 1 TO 100: NEXT 

ON 

This command turns the GOTO and GOSUB commands into special 
versions of the IF statement. ON is followed by a formula, which is 
evaluated. If the result of the calculation is one, the first line on the list is 
executed; if the result is 2, the second line is executed, and so on. If the 
result is 0, negative, or larger than the list of numbers, the next line 
executed will be the statement following the ON statement. 

10 INPUT X 

20 ON X GOTO 10,20,30,40,50 

OPEN 

The OPEN statement allows the Commodore 64 to access devices such 
as the cassette recorder and disk for data, a printer, or even the screen. 
OPEN is followed by a number (0-255), to which all following statements 
will refer. There is usually a second number after the first, which is the 
device number. 

The device numbers are: 

0 Screen 

1 Cassette 
4 Printer 

8 Disk 

Following the device number may be a third number, separated 
again by a comma, which is the secondary address. In the case of the 
cassette, this is 0 for read, 1 for write, and 2 for write with end-of-tape 
marker. 

In the case of the disk, the number refers to the buffer, or channel, 
number. In the printer, the secondary address controls features like ex¬ 
panded printing. See the Commodore 64 Programmer s Reference Man¬ 
ual for more details. 
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10 OPEN 1,0 
20 OPEN 2,1 ,0 f "D" 

30 OPEN 3,4 
40 OPEN 4,8,15 


OPENs the SCREEN as a device 
OPENs the cassette for reading, 
file to be searched for is D 
OPENs the printer 

OPENs the data channel on the disk 


Also see: CLOSE, CMD, GET#, INPUT#, and PRINT#, system variable 
ST, and Appendix B. 


POKE 


POKE is always followed by two numbers, or formulas. The first loca¬ 
tion is a memory location; the second number is a decimal value from 0 
to 255, which will be placed in the memory location, replacing any pre¬ 
viously stored value. 

10 POKE 53281,0 

20 S=4096* 13 
30 POKE S+29,8 

PRINT 

The PRINT statement is the first one most people learn to use, but 
there are a number of variations to be aware of. PRINT can be followed 

by: 

Text String with quotes 
Variable names 
Functions 

Punctuation marks 

Punctuation marks are used to help format the data on the screen. 
The comma divides the screen into four columns, while the semicolon 
suppresses all spacing. Either mark can be the last symbol on a line. 
This results in the next thing PRINTed acting as if it were a continuation 
of the same PRINT statement. 

10 PRINT "HELLO" 

20 PRINT "HELLO",A$ 

30 PRINT A+B 
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40 PRINT J; 

60 PRINT A,B,C,D 


Also see: POS, SPC and TAB functions 

PRINT# 

There are a few differences between this statement and PRINT. 
PRINT# is followed by a number, which refers to the device or data file 
previously OPENed. This number is followed by a comma and a list to be 
printed. The comma and semicolon have the same effect as they do in 
PRINT. Please note that some devices may not work with TAB and SPC. 

100 PRINT# 1/'DATA VALUES"; A%, Bl, C$ 

READ 

READ is used to assign information from DATA statements to vari¬ 
ables, so the information may be put to use. Care must be taken to 
avoid READing strings where READ is expecting a number, which will 
give a TYPE MISMATCH ERROR. 

REM (Remark) 

REMark is a note to whomever is reading a LIST of the program. It 
may explain a section of the program, or give additional instructions. 
REM statements in no way affect the operation of the program, except 
to add to its length. REM may be followed by any text. 

RESTORE 

When executed in a program, the pointer to which an item in a DATA 
statement will be READ next is reset to the first item in the list. This gives 
you the ability to re-READ the information. RESTORE stands by itself on a 
line. 

RETURN 

This statement is always used in conjunction with GOSUB. When the 
program encounters a RETURN, it will go to the statement immediately 
following the GOSUB command. If no GOSUB was previously issued, a 
RETURN WITHOUT GOSUB ERROR will occur. 
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STOP 


This statement will halt program execution. The message, BREAK IN 
xxx will be displayed, where xxx is the line number containing STOP. The 
program may be restarted by using the CONT command. STOP is nor¬ 
mally used in debugging a program. 

SYS 

SYS is followed by a decimal number or numeric value in the range 
0-65535. The program will then begin executing the machine language 
program starting at that memory location. This is similar to the USR 
function, but does not allow parameter passing. 

WAIT 

WAIT is used to halt the program until the contents of a memory loca¬ 
tion changes in a specific way. WAIT is followed by a memory location 
(X) and up to two variables. The format is: 

WAIT X,Y,Z 

The contents of the memory location are first exclusive-ORed with the 
third number, if present, and then logically ANDed with the second 
number. If the result is zero, the program goes back to that memory 
location and checks again. When the result is nonzero, the program 
continues with the next statement. 


NUMERIC FUNCTIONS 

ABS(X) (absolute value) 

ABS returns the absolute value of the number, without its sign ( + or 
—). The answer is always positive. 

ATN(X) (arctangent) 

Returns the angle, measured in radians, whose tangent is X. 
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COS(X) (cosine) 


Returns the value of the cosine of X, where X is an angle measured in 
radians. 

EXP(X) 

Returns the value of the mathematical constant e(2.718271 83) raised 
to the power of X. 

FNxx(X) 

Returns the value of the user-defined function xx created in a DEF 
FNxx(X) statement. 

INT(X) 

Returns the truncated value of X, that is, with all the decimal places 
to the right of the decimal point removed. The result will always be less 
than, or equal to, X. Thus, any negative numbers with decimal places 
will become the integer less than their current value. 

LOG(X) (logarithm) 

Will return the natural log of X. The natural log to the base e (see 
EXP(X)). To convert to log base 10, simply divide by LOG(IO). 

PEEK(X) 

Used to find out contents of memory location X, in the range 0-65535, 
giving a result from 0-255. PEEK is often used in conjunction with the 
POKE statement. 

RND(X) (random number) 


RND(X) returns a random number in the range 0-1. The first random 
number should be generated by the formula RND( Tl) to start things off 
differently every time. After this, X should be a 1 or any positive 
number. If X is zero, the result will be the same random number as the 
last one. 
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A negative value for X will reseed the generator. The use of the same 
negative number for X will result in the same sequence of "random" 
numbers. 

The formula for generating a number between X and Y is: 

N = RND(1)*(Y—X)+X 


where, 

Y is the upper limit 

X is the lower range of numbers desired. 

SGN(X) (sign) 

This function returns the sign (positive, negative, or zero) of X. The 
result will be +1 if positive, 0 if zero, and —1 if negative. 

SIN(X) (sine) 

SIN(X) is the trigonometric sine function. The result will be the sine of 
X, where X is an angle in radians. 

SQR(X) (square root) 

This function will return the square root of X, where X is a positive 
number or 0. If X is negative, an ILLEGAL QUANTITY ERROR results. 

TAN(X) (tangent) 

The result will be the tangent of X, where X is an angle in radians. 

USR(X) 

When this function is used, the program jumps to a machine language 
program whose starting point is contained in memory locations. The pa¬ 
rameter X is passed to the machine language program, which will re¬ 
turn another value back to the BASIC program. Refer to the Commodore 
64 Programmer's Reference Manual for more details on this function 
and machine language programming. 
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STRING FUNCTIONS 

ASC(X$) 

This function will return the ASCII code of the first character of X$. 

CHR$(X) 

This is the opposite of ASC, and returns a string character whose 
ASCII code is X. 

LEFT$(X$,X) 

Returns a string containing the leftmost X characters of $X. 

LEN(X$) 

Returned will be the number of characters (including spaces and 
other symbols) in the string X$. 

MID$(X$,S,X) 

This will return a string containing X characters starting from the Sth 
character in X$. 

RIGHT$(X$,X) 

Returns the rightmost X characters in X$. 

STR$(X) 

This will return a string which is identical to the PRINTed version of X. 


VAL(X$) 

This function converts X$ into a number, and is essentially the inverse 
operation from STR$. The string is examined from the leftmost character 
to the right, for as many characters as are in recognizable number for¬ 


mat. 






10 X = VAL(" 123.456") 

X = 123.456 

10 X = VAL("12A13B") 

X = 12 

10 X = VAL("RIU017") 

X = 0 

10 X = VAL ("— 1.23.45.67") 

X = -1.23 

OTHER FUNCTIONS 



FRE(X) 


This function returns the number of unused bytes available in memory, 
regardless of the value of X. Note that FRE(X) will read out n negative 
numbers if the number of unused bytes is over 32K. 

POS(X) 

This function returns the number of the column (0-39) at which the 
next PRINT statement will begin on the screen. X may have any value 
and is not used. 

SPC(X) 

This is used in a PRINT statement to skip X spaces forward. 

TAB(X) 

TAB is also used in a PRINT statement; the next item to be PRINTed will 
be in column X. 
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APPENDIX D 
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V 


ABBREVIATIONS FOR 
BASIC KEYWORDS 


As a time-saver when typing in programs and commands. Commo¬ 
dore 64 BASIC allows the user to abbreviate most keywords. The ab¬ 
breviation for PRINT is a question mark. The abbreviations for other 
words are made by typing the first one or two letters of the word, fol¬ 
lowed by the SHIFTed next letter of the word. If the abbreviations are 
used in a program line, the keyword will LIST in the full form. 


Com- Abbrevi- 
mand ation 


ABS 

AND 

ASC 

ATN 

CHR$ 

CLOSE 

CLR 

CM D 

CONT 

COS 

DATA 

DEF 

DIM 


a mm 
a 

A BSE 

a mm 

c 

clBEE 

c msi 

c 

c BSE 

NONE 

d BSZE 
d BSflU 

d E3 


B 

N 

S 

T 

H 

O 

L 

M 

O 

A 

E 

I 


Looks like 
this on 
screen 

Com¬ 

mand 

a[D 

END 

A 0 

EXP 

A® 

FN 

aD 

FOR 

c □ 

FRE 

clD 

GET 

<=□ 

GET# 

C S 

GOSUB 

C[J 

GOTO 

cos 

IF 

D ® 

INPUT 

D B 

INPUT# 

D Q 

INT 


Abbrevi 

ation 


E N 


SHIFT 


NONE 


SHIFT 

SHIFT 

SHIFT 


NONE 

goESBJs 
g BS 3 S 9 ° 

NONE 

NONE 


SHIFT 


NONE 


Looks like 
this on 
screen 

* 0 " 
E ® 


f n 

F □ 

G B 

GET# 

GO® 

G □ 


INPUT 

• 0 
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Com¬ 

mand 


Abbrevi¬ 

ation 


Looks like 
this on 
screen 


Looks like 
fhrs on 
screen 


* Z 


r 


GO_V_ 

G C 

INPUT 

■ z 




LEFTS 

LEN 

LET 

LIST 

LOAD 

LOG 

MID$ 

NEW 

NEXT 

NOT 

ON 

OPEN 

OR 

PEEK 

POKE 

POS 

PRINT 

PRINT# 

READ 

REM 

RESTORE 

RETURN 


LE EJ 

NONE 
L 
L 
L 

NONE 

m EE 

NONE 

N ffilbl E 
N E'illiH O 

NONE 

°QI p 

NONE 

P filhafl E 
P BtMi O 

NONE 

9 


p ese 

r ESS 

NONE 

RE El 

RE Biff; 


R 

E 

S 

T 


LE B 

LEN 

E □ 
E □ 

E □ 

LOG 

mQ 

NEW 
N □ 
N □ 
ON 

on 

OR 

p B 

p n 

POS 

? 

p □ 

R B 

REM 

RE ® 

r eQH 


Com¬ 

mand 


Abbrevi¬ 

ation 


Looks like 
this on 
screen 


RIGHTS R I 


RND 

RUN 

SAVE 

SGN 

SIN 

SPC( 

SQR 


R EHiil N 

resbi u 

s mm a 
s EHiil g 


S I 
S I 

S I 


STATUS ST 
STEP ST I 


STOP 

STR$ 

SYS 

TAB( 

TAN 

THEN 

TIME 

TIMES 

USR 

VAL 

VERIFY 

WAIT 


S ES 
ST El 

S 

t EH 

NONE 
T 
Tl 
TIS 

u EBEB s 
v Elilil a 
v Emu e 

w a 


I 

P 

Q 

E 

T 

R 

Y 

A 


H 


r Q 
R 0 
R □ 
s S 
s D 

S □ 

s n 

♦ 

ST 

ST B 

sB 

stB 

S □ 

T ® 
TAN 

Tl 

Tl$ 

u ® 

V ® 

vQ 

w® 


INT 
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SCREEN DISPLAY CODES 


The following chart lists all of the characters built into the Commodore 
64 character sets. It shows which numbers should be POKEd into screen 
memory (locations 1024-2023) to get a desired character. Also shown is 
which character corresponds to a number PEEKed from the screen 
Two character sets are available, but only one set at a time. This 
means that you cannot have characters from one set on the screen at 
the same time you have characters from the other set displayed. The 
sets are switched by holding down the KtilUl and B keys s ' mU ' 

taneously. , 

From BASIC, POKE 53272,21 will switch to upper case mode and 

POKE 53272,23 switches to lower case. 

Any number on the chart may also be displayed in REVERSE. T e 
reverse character code may be obtained by adding 128 to the values 

If you want to display a solid circle at location 1504, POKE the code 
for the circle (81) into location 1504: POKE 1504,81. 

There is a corresponding memory location to control the color of each 
character displayed on the screen (locations 55296-56295). To change 
the color of the circle to yellow (color code 7) you would POKE the corre¬ 
sponding memory location (55776) with the character color: POKE 

55776,7. 

Refer to Appendix G for the complete screen and color memory 
maps, along with color codes. 


SCREEN CODES 
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S3E^ 2 POKE 


6 

7 

8 



SET 1 

SET 2 

POKE 

SET 1 

SET 2 POKE 

SET 1 

SET 2 

POKE 

1 

i 

9 

% 

37 

S 

A 

65 

J 

j 

10 

& 

38 

m 

B 

66 

K 

k 

11 

' 

39 

B 

c 

67 

L 

1 

12 

( 

40 

B 

D 

68 

M 

m 

13 

) 

41 

□ 

E 

69 

N 

n 

14 

* 

42 

□ 

F 

70 

0 

0 

15 

+ 

43 

□ 

G 

71 

p 

P 

16 


44 

□ 

H 

72 

Q 

q 

17 

- 

45 

□ 

1 

73 

R 

r 

18 


46 

□ 

J 

74 

s 

s 

19 

/ 

47 

□ 

K 

75 

T 

t 

20 

0 

48 

□ 

L 

76 

U 

u 

21 

1 

49 

K 

M 

77 

V 

V 

22 

2 

50 

0 

N 

78 

w 

w 

23 

3 

51 

□ 

O 

79 

X 

X 

24 

4 

52 

□ 

P 

80 

Y 

y 

25 

5 

53 

m 

Q 

81 

z 

z 

26 

6 

54 

□ 

R 

82 

[ 


27 

7 

55 


S 

83 

£ 


28 

8 

56 

□ 

T 

84 

] 


29 

9 

57 

□ 

U 

85 

T 


30 


58 


V 

86 


1 

31 

9 

59 

□ 

w 

87 

SPACE 

1 

32 

< 

60 

® 

X 

88 

! 


33 

= 

61 

CD 

Y 

89 

“ 


34 

> 

62 

OB 

z 

90 

# 


35 

? 

63 

ffl 


91 

$ 


36 

B 

64 

E 


92 




























SET 1 

SET 2 

POKE 

SET 1 

m 


93 

E 

0 


94 

□ 

a 


95 


SPACE 

1 

96 

a 

n 


97 

□ 

Q 


98 ! 

ED 

n 


99 

a 

□ 


100 

E 

□ 


101 

S 

m 


102 

H 

□ 


103 

ffl 

a 


104 

D 


POKE 

SET 1 SET 2 POKE 

105 

E 

117 

106 

□ 

118 

107 

n 

119 

108 

n 

120 

109 

a 

121 

110 

□ v/ 

122 

111 

B 

123 

112 

a 

124 

113 

H 

125 

114 

E 

126 

115 

S 

127 

116 




Codes from 128-255 are reversed images of codes 0-127. 
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119 

120 
121 
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123 
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ASCII AND CHR$ CODES 


This appendix shows you what characters will appear if you PRINT 
CHR$(X), for all possible values of X. It will also show the values ob¬ 
tained by typing PRINT ASC("x"), where x is any character you can type. 
This is useful in evaluating the character received in a GET statement, 
converting upper/lower case, and printing character based commands 
like switch to upper/lower case) that could not be enclosed in quotes. 


PRINTS 

CHR$ 

PRINTS 

CHR$ 

PRINTS 

CHR$ 

PRINTS 

CHR$ 


0 


17 

“ 

34 

3 

51 


1 


18 

# 

35 

4 

52 


2 

■ QH 

■ how ■» 

19 

$ 

36 

5 

53 


3 

fsm 

1»!S88 

20 

% 

37 

6 

54 


4 


21 

& 

38 

7 

55 

Bk 

5 


22 


39 

8 

56 


6 


23 

( 

40 

9 

57 


7 

i 


24 

) 

41 


58 

DISABLES [EB (^8 


25 

* 

42 

9 

59 

ENABLES QDIQg 


26 

+ 

43 

<z 

60 


10 


27 

9 

44 

= 

61 


11 

J|||| 

28 

- 

45 

z> 

62 


12 


29 


46 

? 

63 

1 RETURN 

13 


30 

/ 

47 

@ 

64 1 

Wh 

14 

m 

31 

0 

48 

A 

65 1 


15 

| SPACE |f 

32 

1 

49 

B 

66 


16 

! 

33 

2 

50 

C 

67 
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PRINTS 

CHR$ 

PRINTS 

CHR$ 

PRINTS CHR$ 

PRINTS 

CHR$ 

D 

68 


97 

E 


126 

03 

155 

E 

69 

m 

98 

a 

127 

A 

156 

F 

70 

B 

99 



128 


157 

G 

71 

B 

100 

[ 


129 

A 

158 

H 

72 

□ 

101 



130 

A 

159 

1 

73 

B 

102 



131 

1 SPACE | 

160 

J 

74 

□ 

103 



132 

D 

161 

K 

75 

□ 

104 

fi 

133 

H 

162 

L 

76 

Q 

105 

f3 

134 

n 

163 

M 

77 

□ 

106 

f5 

135 

□ 

164 

N 

78 

□ 

107 

f7 

136 

□ 

165 

0 

79 

□ 

108 

f2 

137 

m 

166 

P 

80 

E 

109 

f4 

138 

□ 

167 

Q 

81 

0 

110 

f6 

139 

s 

168 

R 

82 

□ 

111 

f8 

140 

B 

169 

S 

83 

□ 

112 

Qggi 41 

□ 

170 

T 

84 

H 

113 

BH 1 * 2 

CB 

171 

U 

85 

□ 

114 



143 

a 

172 

V 

86 


115 

1 

Mi 144 

H 

173 

w 

87 

□ 

116 


|||j 145 

H 

174 

X 

88 

□ 

117 

i 

KH 146 

a 

175 

Y 

89 

0 

118 


B 147 

H 

176 

z 

90 

O 

119 


B 148 

H 

177 

[ 

91 


120 


□ 149 

H 

178 

£ 

92 

□ 

121 


0 150 

ffl 

179 

] 

93 

IS 

122 


O 151 

C 

180 

T 

94 

ffi 

123 


® 152 

c 

181 


95 

D 

124 


□ 153 

[1 

182 

B 

96 

m 

125 


ffl 154 

□ 

183 
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CHRS 


*56 


5 ■* 

5-5 

55 


5C 


5«5 



PAINTS 

CHR$ 

PRINTS 

CHR$ 

PRINTS 

CHR$ 

PRINTS 

CHR$ 

— 

184 

□ 

186 

a 

188 

E 

190 


185 

□ 

187 

a 

189 

S 

191 


CODES 192-223 SAME AS 96-127 

CODES 224-254 SAME AS 160-190 

CODE 255 SAME AS 126 
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APPENDIX G 


SCREEN AND COLOR MEMORY MAPS 

The following charts list which memory locations control placing char¬ 
acters on the screen, and the locations used to change individual char¬ 
acter colors, as well as showing character color codes. 


SCREEN MEMORY MAP 

COLUMN 

0 10 20 30 39 


1063 
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ne acfual values to POKE into a color memory location to change a 
character's color are: 


0 BLACK 

1 WHITE 

2 RED 

3 CYAN 

4 PURPLE 

5 GREEN 

6 BLUE 

7 YELLOW 


8 

ORANGE 

9 

BROWN 

10 

Light RED 

1 1 

GRAY 1 

12 

GRAY 2 

13 

Light GREEN 

14 

Light BLUE 

15 

GRAY 3 


For example, to change the color of a character located at the 
eft-hand corner of the screen to red, type: POKE 55296,2. 


upper 


COLOR MEMORY MAP 


0 


10 


COLUMN 

20 


30 


39 

55335 


















































































































































































































































APPENDIX H 


DERIVING MATHEMATICAL FUNCTIONS 

Functions that are not intrinsic to Commodore 64 BASIC may be calcu¬ 
lated as follows: 


FUNCTION 

BASIC EQUIVALENT 

SECANT 

COSECANT 

COTANGENT 

INVERSE SINE 

INVERSE COSINE 

SEC(X)= l/COS(X) 

CSC(X)=l/SIN(X) 

COT(X)=l/TAN(X) 

ARCSIN(X)=ATN(X/$QR(—X*X+1)) 
ARCCOS(X)= — ATN(X/SQR 
(-X*X +1)) +7t/2 

INVERSE SECANT 

INVERSE COSECANT 

ARCSEC(X)=ATN(X/SQR(X*X— 1)) 
ARCCSC(X)=ATN(X/SQR(X*X— 1)) 

+ (SGN(X)— 1 *7t/2 

INVERSE COTANGENT 

HYPERBOLIC SINE 

HYPERBOLIC COSINE 

HYPERBOLIC TANGENT 

ARCOT(X)=ATN(X)+tt/2 

SINH(X)=(EXP(X)—EXP(—X))/2 
COSH(X)=(EXP(X)+ EXP(— X))/2 
TANH(X)=EXP(—X)/(EXP(x)+ EXP 
(—X))*2 + 1 

HYPERBOLIC SECANT 

HYPERBOLIC COSECANT 

HYPERBOLIC COTANGENT 

SECH(X)=2/(EXP(X)+ EXP(—X)) 
CSCH(X)=2/(EXP(X)-EXP(-X)) 

COTH(X)= EXP(—X)/(EXP(X) 

— EXP(—X))*2+ 1 

INVERSE HYPERBOLIC SINE 

INVERSE HYPERBOLIC COSINE 

INVERSE HYPERBOLIC TANGENT 

INVERSE HYPERBOLIC SECANT 

ARCSINH(X)= LOG(X + SQR(X*X+ 1)) 
ARCCOSH(X)= LOG(X + SQR(X*X— 1)) 
ARCTANH(X)=LOG«l +X)/(1 -X))/2 
ARCSECH(X)=LOG((SQR 
(-X*X+l)+l/X) 

INVERSE HYPERBOLIC COSECANT 

ARCCSCH(X)= LOG((SGN (X)* SQR 
(X*X+ l/x) 

INVERSE HYPERBOLIC COTAN¬ 
GENT 

ARCCOTH(X)= LOG((X+ 1 )/(x- 1 ))/2 
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PINOUTS FOR INPUT/OUTPUT DEVICES 


This appendix is designed to show you what connections may be 
made to the Commodore 64. 

1) Game I/O 4) Serial I/O (Disk/Printer) 

2) Cartridge Slot 5) Modulator Output 

3) Audio/Video 6) Cassette 

7) User Port 


Control Port 1 


Pin 

Type 

Note 

1 

JOYAO 


2 

JOYA1 


3 

JOYA2 


4 

JOYA3 


5 

POT AY 


6 

BUTTON A/LP 


7 

+ 5V 

MAX. 50mA 

8 

GND 


9 

POT AX 




Control Port 2 


Pin 

Type 

Note 

1 

JOYBO 


2 

JOYB1 


3 

JOYB2 


4 

JOYB3 


5 

POT BY 


6 

BUTTON B 


7 

+ 5V 

MAX. 50mA 

8 

GND 


9 

POT BX 
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Cartridge Expansion Slot 


Pin 

Type 

12 

BA 

13 

DMA 

14 

D7 

15 

D6 

16 

D5 

17 

D4 

18 

D3 

19 

D2 

20 

D1 

21 

DO 

22 

GND 


Pin 

Type 

1 

GND 

2 

+ 5V 

3 

+ 5V 

4 

IRQ 

5 

R/W 

6 

Dot Ciock 

7 

I/O 1 

8 

GAME 

9 

EXROM 

10 

I/O 2 

11 

ROML 


Pin 

Type 

A 

GND 

B 

ROMH 

C 

RESET 

D 

NMI 

E 

S 02 

F 

A15 

H 

A14 

J 

A13 

K 

A12 

L 

A11 

M 

A10 


Pin 

Type 

N 

A9 

P 

A8 

R 

A7 

S 

A6 

T 

A5 

U 

A4 

V 

A3 

W 

A2 

X 

A1 

Y 

A0 

Z 

GND 


22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 


■ ■ ■ mmmamiLftmmjMULimum 

ZY XWVUTSRPNMLKJHFEDCBA 

Audio/Video 


Pin 

Type 

Note 

1 

LUMINANCE 


2 

GND 


3 

AUDIO OUT 


4 

VIDEO OUT 


5 

AUDIO IN 



Serial I/O 




Pin 

Type 

1 

SERIAL SRQIN 

2 

GND 

3 

SERIAL ATN IN/OUT 

4 

SERIAL CLK IN/OUT 

5 

SERIAL DATA IN/OUT 

6 

RESET 
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Cassette 


Pin 

Type 

A-l 

GND 

B-2 

+ 5V 

C-3 

CASSETTE MOTOR 

D-4 

CASSETTE READ 

E-5 

CASSETTE WRITE 

F-6 

CASSETTE SENSE 


1 2 3 4 5 6 



A B C D E F 


User I O 


Pin 

Type 

Note 

1 

GND 


2 

+ 5V 

MAX. 100 mA 

3 

RESET 


4 

CNT1 


5 

SP1 


6 

CNT2 


7 

SP2 


8 

PC2 


9 

SER. ATN IN 


10 

9 VAC 

MAX. 100 mA 

11 

9 VAC 

MAX. 100 mA 

12 

GND 



Pin 

Type 

Note 

A 

GND 


B 

FLAG2 


C 

PBO 


D 

PB1 


E 

PB2 


F 

PB3 


H 

PB4 


J 

PB5 


K 

PB6 


L 

PB7 


M 

PA2 


N 

GND 


1 2 ; 

3 4 5 6 7 8 9 

10 11 12 


ABCDEFHJ KLMN 
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APPENDIX J 


PROGRAMS TO TRY 


We ve included o number of useful programs 
Commodore 64. These programs will prove 
useful. 
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. .% th your 
"g and 





orint‘ 
Dr i nt 1 
Dr j nt" 
Drint" 

Drint" 

Dr j nt" 

dsts 

data 

data 

data 

data 

data 

data 

data 


zr ^j otto jim butterfield" 

. rDU * ^“ 3nt instructions"^* : i fasc<z*)=78goto250 
Drmt ?try to guess the mystery 5-letter word" 
print’Pyou ,l,us t guess only legal 5-letter" 
Drint"uords, too..." 

orint you will be told the number of matches" 

(or "jots 7 ) of your guess." 

5*hint: the trick is to vary slightly" 
from one guess to the next? so that" 
if you guess ’batch’ and get 2 jots" 
you might try ’botch' or ’chart’" 

for the next guess_" 

bxbsf,ipccz,dbdif,esfbe,pggbm 
hpshf,ibudi,dj wj m f kpmmz,Ibzbl 
sbkbi,mfwfm,njnjd,boofy,qjqfs 

rvftu,sjwfs,qsftt,puufs,fwfou 

xf bwf.fyupm,nvtiz,afcsb , gj aaz 

u ' Jdl,esvol,gmppe,ujhfs,gblfs 

cppui, mzjoh,trvbu,hbvaf,pxjoh 
u i sff , tjhiu,bymft,hsvnq,bsfob 
data rvbsu,dsffq,cfmdi,qsftt,tqbsl 
data sbebs,svsbm,tnfmm f gspxo, esjgu 
n = 50 

dim n$<n),z(5),y<5) 
for j = 1 ton:readn$(j):nextj 
t = t i 

t = t/ 1000 : ift>=lthengoto **0 
z = rnd <-t) 

g=0;n$=n$(rnd(l)*n+1) 
print "Pi have a five letter word: 

''guess (with legal words)" 
and i ll tell you how many" 
jots , or matching letters," 

"you have... . " 
input "your word";z$ 
if len(z$)OSthenprint"you must guess a 
5-letter word!":goto560 
v=0:h=0:m=0 
f orj =1to5 

z=asc(mid$(z$,j,l)):y=asc(mid$<n$,j, 1 ))~i 
ifz<s6uorz>90thenpr int"that’s not a word!" 


130 

1*0 

150 

160 

170 

130 

190 

200 

210 

220 

250 

260 

270 

230 

290 

300 

310 

320 

330 

3*0 

*00 

*10 

*20 

*30 

**0 

*50 

500 

510 

520 

530 

5*0 

550 

560 

570 

530 
590 
600 
610 
620 
630 
6*0 
6 50 
660 


pr i nt 
pr i nt 
pr i nt 
pr i nt 
g=g+i j 


: ifr>0goto560 


=85orz=8?thenv=v+l 


670 

630 

690 

700 

710 

720 

730 

7*0 

750 

300 

310 

320 


= 0 : g o t o 7 0 0 


' fz = 65orz = 69orz = 73orz = 79or 
i f z=ythenm = m + l 
z(j)= z:y(j)= y;next j 
if m=5gotoS00 

ifv=0orv=5thenpr inf'coiiie on..what kind of 
a word is that?":qoto560 
for j=lto5:y=y<j) 
for k=lto5:ify=z<k)thenh=h+l:z<k) 
next k 
next j 

Dr i nt"DBBflEBBBBBflBflBBBBBBB" ,-Hs " JOTS" 
i fg<30goto560 

print"i’d-better tell you., word was 
forj=lto5:#rintchr$(y(j)) ;:n *xtj 
pr i nt"’":gotoSlO 

print"you got it in only" ,g f "guesses 
input"^another word";z$ 
r=l : ifasc(z$)<>73goto500 


ify=6*theny= 

goto560 


145 







595 t=0 

600 r e m reverse substring 

605 t = t + l „ v 

610 input "how many to reverse ?rX 



620 if r%=0 goto 900 

630 if r%>0 snd r%<=s goto 650 

640 print "must be between 1 and "?s: goto 

650 r=int<r%/2) 

660 for i=1 to r 
670 t$=s*(i) 

680 a$( i>=a* <r%-i+1) 

690 a$<r%-i + 1 )=t$ 

700 next i 

750 g o s u b 950 

800 c=1: for i=2 to s 

810 if a$<i)>a$<i~1) goto 830 

820 c=0 

830 next i 

840 if c=0 goto 600 _ n 

850 print "Pyou did it in ";t?" tries 
900 rem check for another game 
910 input "Pwant to plsy sgsin "iy* 

920 if lefts (y$ , 1> = "y'* or y$ = "ok" or y$= 1 
930 end 
950 print 

960 print left$<zl*,s> 

970 for i=1 to s: print a$(i);:next \ 

980 print "P" 

990 return 


610 


goto 


200 


This program courtesy of Gene Deals 
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P R I IT 
- - INT 


~ = IN! 
T NT 


350 

360 

“ 70 


2 2 0 


400 


Z 1 0 
-~v\ 


~ 40 


570 
~ 30 
530 
r* m 


[HNQ KEYBOARD 

- s si n i m i'j a i m nji i mi ;i|{ - 

3 M iJ I ill M SI i iy (aj I m jnj .. 

3 w I L«J si si I SI iUi I fifl |II| •• 

’ 3 I I I | | | | | | | , | .. 

Z?-! JW IE |R |T |V |IJ j I 10 |R |i5 );f: |f" 

'a'SPACE-' FOR SOLO OR PQLVFHONIC" 

^ OOT STF1,F3,F5,F7' OCTAVE SELECTION" 

0 PR IHT " a_' FLF4 , F 6 , F3 •' WAVE FORM TV 1 
0 PRINT"HANG ON, SETTING UP FREQUENCY TABLE 
J S= 13+4096+1024 : DIMF < 26 : D IMK <255 > 

. FOR I =0T028 : P0KES+ I , Ti; NEXT 

? F 1=7040! FOR I = 1T02S :F< 27-1 > =F 1 +5.8+30 ;F1=F1 ,-->f1 ,i o. WP , T 
-* Ki= " Q2W3ER5T6V7U19G0P0—:+ £ f " ME, "' ,T 

• pr^T" 3 ° LeH(K *‘ > !K<fiSC<MID *<K*.-1 > > >-I iHEXT 

5 U. T= ® : D , E= ® ! S u =15 :RE=9 ,SV-SU*16 + RE ,flV-RT*16 + DE : " 

N • = 1s w=U :M=s .l : UU =4 : HB=256 : Z-F 

! 1 * 7 - «T* l'sloE : P0KES+6+1 *7. SU* 1 « + PE 

’ 3- "J- '' 4W «WHHD255:P0KES+3+I*7,40<W2 *W. NE vt 

• D UkE»+i:4,15 JREM+16+64 sP0KES+2*.7 E " T 

1 GETfii:IFR$=""THEH3O0 

! I™™™* 0 ™?”™*™*? »CR-S + T + 4 = IFFR-ZTHENS0R 
PUkE'+t+T r Z :REM FINISH DEO/Al is 

P0KES+5+T,Z :REM FINISH ATT,-'PEL 
P0KECR .pS :POKECR ,0 : REM FIN OFF 
POKES+T,FR-HB*INT < FR/HB>:REM SET LO 
POKES+1+T,FR/HB:REM SETHI 
P0KES+6+T, $V : REM SET DEC/SIJA 
P0KES+5+T,AVsREM SET ATT/PEL 
POKECRWV+1 : FOR I .-= 1T05G+AT : NE-T 
POKECR,WV:REM PULSE 
IFP=1THENV=V+1sIFV-3THENV-0 
00TO300 

I FA*-= " to" THENM= 1 : 0C=4 s GOTO3O0 
IFA$="jg"THENM»2:0C=3:GOTO380 
IFhT= " IS" THEN Ns 4 : 0C«2 : on TO 800 
IFA*="S|"THENM=S :0C=1 :GOTQ300 
IFA$ =" THENW=0 s WV= 16:GOT0800 
IFA^ss" K»THENWb 1 : WV-32 : OOT0800 
IFA^= " *$" THENW=2 : WV=64 :GOTO30O 
IFAT=" B"THENW=3 :W'v'=12S :GOT0300 
IFA$=" "THENPb 1 —P:GOTO800 
I FA^ss" □" THEN200 
GOTO300 

PRINT-HIT A KEY" 

- E TFl7 :1FR7 = " " THENS1 © : WAIT FOR A K E V 
PRINTA#:RETURN 



NOTES: 

Line 100 uses (SHIFT CLR/HOME 
CTRL 9),(CTRL J),(SHIFT B). 

Line 150 uses (CRSR DOWN) 

Line 240 uses (CRSR UP) 

Line 500 uses (fl) 

Line 510 uses (f3) 

Line 520 uses (f5) 


Line 530 uses (f7) 

Line 540 uses (f2) 

Line 550 uses (f4) 

Line 560 uses (f6) 

Line 570 uses (f8) 

Line 590 uses (SHIFT CLR/HOME) 
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APPENDIX K 


CONVERTING STANDARD 
BASIC PROGRAMS TO 
COMMODORE 64 BASIC 


If you have programs written in a BASIC other than Commodore 
BASIC, some minor adjustments may be necessary before running them 
on the Commodore-64. We've included some hints to make the conver¬ 
sion easier. 


String Dimensions 

Delete all statements that are used to declare the length of strings. A 
statement such as DIM A$(l / J) / which dimensions a string array for J 
elements of length 1, should be converted to the Commodore BASIC 
statement DIM A$(J). 

Some BASICs use a comma or ampersand for string concatenation. 
Each of these must be changed to a plus sign, which is the Commodore 
BASIC operator for string concatenation. 

In Commodore-64 BASIC, the MID$, RIGHTS, and LEFTS functions are 
used to take substrings of strings. Forms such as A$(l) to access the Ith 
character in AS, or A$(I,J) to take a substring of A$ from position I to J, 
must be changed as follows: 


Other BASIC Commodore 64 BASIC 

A$(l) = X$ A$ = LEFT$(A$,I— 1 ) + X$ + MID$(A$,l +1) 

A$(I,J) = X$ A$ = LEFTS(A$,I-1) + X$ + MID$(A$,J+1) 


Multiple Assignments 

To set B and C equal to zero, some BASICs allow statements of the 
form: 










-' : I: m o d o re 
e~c inning them 
: ~ ~« e *ne conver- 


of strings. A 
: s^ -g array for J 
: d 2 r e BASIC 

' *9 concatenation, 
s “"5 C;mmodore 

*jnctions are 
access the Ith 
: ocsition I to J, 



m +i 

A$ J-l) 


s*o'ements of the 




Commodore 64 BASIC would interpret the second equal sign as a 
logical operator and set B = —1 if C = 0. Instead, convert this state¬ 
ment to: 

10 C = 0 : B = 0 

Multiple Statements 

Some BASICs use a backslash (\ ) to separate multiple statements on 
a line. With Commodore 64 BASIC, separate all statements by a colon 

(:)• 

MAT Functions 

Programs using the MAT functions available on some BASICs must be 
rewritten using FOR. . .NEXT loops to execute properly. 
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APPENDIX L 


ERROR MESSAGES 


This appendix contains a complete list of the error messages gener¬ 
ated by the Commodore-64, with a description of causes. 

BAD DATA String data was received from an open file, but the pro¬ 
gram was expecting numeric data. 

BAD SUBSCRIPT The program was trying to reference an element of 
an array whose number is outside of the range specified in the DIM 
statement. 

CAN'T CONTINUE The CONT command will not work, either because 
the program was never RUN, there has been an error, or a line has 
been edited. 

DEVICE NOT PRESENT The required I/O device was not available for 
an OPEN, CLOSE, CMD, PRINT#, INPUT#, or GET#. 

DIVISION BY ZERO Division by zero is a mathematical oddity and not 
allowed. 

EXTRA IGNORED Too many items of data were typed in response to 
an INPUT statement. Only the first few items were accepted. 

FILE NOT FOUND If you were looking for a file on tape, and END-OF- 
TAPE marker was found. If you were looking on disk, no file with that 
name exists. 

FILE NOT OPEN The file specified in a CLOSE, CMD, PRINT#, INPUT#, 
or GET#, must first be OPENed. 

FILE OPEN An attempt was made to open a file using the number of 
an already open file. 

FORMULA TOO COMPLEX The string expression being evaluated 
should be split into at least two parts for the system to work with, or a 
formula has too many parentheses. 

ILLEGAL DIRECT The INPUT statement can only oe used within a pro¬ 
gram, and not in direct mode. 

ILLEGAL QUANTITY A number used as the argument of a function or 
statement is out of the allowable range. 





*c r vmr = L5 


*CT O0PUT =L£ 
DJT 3F SnCa 
DJT 3F 


ov: jun jl* Jkj 


hex mom nur 


IS*" Jfl 


nNG IOC -C»*IG 

HMDN • 


iumn 


six 

MOW if-wr 
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-""^ssoges ge n er¬ 
nes 

’ ie Oct Hie pro- 

* eenent of 
fe: - the DIM 

* because 
r cr a ne has 

: ‘ - • a :: e for 

1 ooc-% and not 

■ r r esDonse to 

t ond END-OF- 
c * -e «•* ^h that 

NPUT#, 

'-^ber of 

"9 evaluated 
■aHt with, or a 

! * r ** t ’ , n a pro- 

3 ^.notion or 




LOAD There is a problem with the program on tape. 

SeXT WITHOUT FOR This is caused by either incorrectly nesting loops 
novng a variable name in a NEXT statement that doesn't correspond 
- *h one in a FOR statement. 

NOT INPUT FILE An attempt was made to INPUT or GET data from a 
e which was specified to be for output only. 

NOT OUTPUT FILE An attempt was made to PRINT data to a file which 
*vas specified as input only. 

OUT OF DATA A READ statement was executed but there is no data 
eft unREAD in a DATA statement. 

OUT OF MEMORY There is no more RAM available for program or 
variables. This may also occur when too many FOR loops have been 
nested, or when there are too many GOSUBs in effect. 

OVERFLOW The result of a computation is larger than the largest 
number allowed, which is 1.70141884E + 38. 

REDIM'D ARRAY An array may only be DIMensioned once. If an array 
variable is used before that array is DIM'd, an automatic DIM operation 
s performed on that array setting the number of elements to ten, and 
any subsequent DIMs will cause this error. 

REDO FROM START Character data was typed in during an INPUT 
statement when numeric data was expected. Just re-type the entry so 
mat it is correct, and the program will continue by itself 

RETURN WITHOUT GOSUB A RETURN statement was encountered, 
and no GOSUB command has been issued. 

STRING TOO LONG A string can contain up to 255 characters. 
’SYNTAX ERROR A statement is unrecognizable by the Commodore 
64. A missing or extra parenthesis, misspelled keywords, etc. 

TYPE MISMATCH This error occurs when a number is used in place of a 
string, or vice-versa. 

UNDEF'D FUNCTION A user defined function was referenced, but it 
-as never been defined using the DEF FN statement. 

UNDEF'D STATEMENT An attempt was made to GOTO or GOSUB or 
* J N a line number that doesn't exist. 

VERIFY The program on tape or disk does not match the program cur- 

rently in memory. 
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APPENDIX M 


MUSIC NOTE VALUES 


This appendix contains a complete list of Note#, actual note, and the 
values to be POKEd into the HI FREQ and LOW FREQ registers of the 
sound chip to produce the indicated note. 


MUSICAL NOTE 

OSCILLATOR FREQ 

NOTE 

OCTAVE 

DECIMAL 

HI 

LOW 

0 

C-0 

268 

1 

12 

1 

o 

1 

u 

284 

1 

28 

2 

D—0 

301 

1 

45 

3 

o 

i 

o 

318 

1 

62 

4 

m 

1 

O 

337 

1 

81 

5 

F—0 

358 

1 

102 

6 

~n 

1 

O 

379 

1 

123 

7 

G-0 

401 

1 

145 

8 

o 

1 

% 

O 

425 

1 

169 

9 

A—0 

451 

1 

195 

10 

o 

1 

% 

< 

477 

1 

221 

11 

B-0 

506 

1 

250 

16 

C-l 

536 

2 

24 

17 

7 

% 

u 

568 

2 

56 

18 

D— 1 

602 

2 

90 

19 

D#-l 

637 

2 

125 

20 

E— 1 

675 

2 

163 

21 

F— 1 

716 

2 

204 

22 

7 

Li- 

758 

2 

246 

23 

G-l 

803 

3 

35 

24 

G#-l 

851 

3 

83 

25 

A-1 

902 

3 

134 

26 

A#— 1 

955 

3 

187 

27 

B— 1 

1012 

3 

244 

32 

C-2 

1072 

4 

48 
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MUSICAL NOTE 

OSCILLATOR FREQ 

NOTE 

OCTAVE 

— 

DECIMAL 

HI 

LOW 

33 

C#-2 

1136 

4 

112 

34 

D—2 

1204 

4 

180 

35 

D#-2 

1275 

4 

251 

36 

E—2 

1351 

5 

71 

37 

F—2 

1432 

5 

152 

38 

F#-2 

1517 

5 

237 

39 

G-2 

1607 

6 

71 

40 

G#-2 

1703 

6 

167 

41 

A—2 

1804 

7 

12 

42 

A#-2 

1911 

7 

119 

43 

B—2 

2025 

7 

233 

48 

C—3 

2145 

8 

97 

49 

C#-3 

2273 

8 

225 

50 

D-3 

2408 

9 

104 

51 

D#-3 

2551 

9 

247 

52 

E-3 

2703 

10 

143 

53 

F-3 

2864 

11 

48 

54 

F# —3 

3034 

11 

218 

55 

G-3 

3215 

12 

143 

56 

G#-3 

3406 

13 

78 

57 

A—3 

3608 

14 

24 

58 

> 

1 

CO 

3823 

14 

239 

59 

B —3 

4050 

15 

210 

64 

C —4 

4291 

16 

195 

65 

C# —4 

4547 

17 

195 

66 

D—4 

4817 

18 

209 

67 

D# —4 

5103 

19 

239 

68 

E—4 

5407 

21 

31 

69 

F—4 

5728 

22 

96 

70 

F# —4 

6069 

23 

181 

71 

G-4 

6430 

25 

30 

72 

G# —4 

6812 

26 

156 

73 

A—4 

7217 

28 

49 

74 

A# —4 

7647 

29 

223 

75 

B —4 

8101 

31 

165 

80 

C-5 

8583 

33 

135 

81 

C# —5 

9094 

35 

134 


153 









































MUSICAL NOTE 

OSCILLATOR FR 

EQ 

NOTE 

OCTAVE 

DECIMAL 

HI 

LOW 

82 

C-0 

9634 

37 

162 

83 

C#-0 

10207 

39 

223 

84 

D—0 

10814 

42 

62 

85 

F—5 

11457 

44 

193 

86 

F#-5 

12139 

47 

107 

87 

G—5 

12860 

50 

60 

88 

G#-5 

13625 

53 

57 

89 

A—5 

14435 

56 

99 

90 

A#-5 

15294 

59 

190 

91 

B—5 

16203 

63 

75 

96 

C—6 

17167 

67 

15 

97 

C#-6 

18188 

71 

12 

98 

D—6 

19269 

75 

69 

99 

D#-6 

20415 

79 

191 

100 

E—6 

21629 

84 

125 

101 

F-6 

22915 

89 

131 

102 

F#-6 

24278 

94 

214 

103 

G-6 

25721 

100 

121 

104 

G#-6 

27251 

106 

115 

105 

A—6 

28871 

112 

199 

106 

A# —6 

30588 

119 

124 

107 

B—6 

32407 

126 

151 

112 

C—7 

34334 

134 

30 

113 

C#-7 

36376 

142 

24 

114 

D—7 

38539 

150 

139 

115 

D# —7 

40830 

159 

126 

116 

E—7 

43258 

168 

250 

117 

F—7 

45830 

179 

6 

118 

F# —7 

48556 

189 

172 

119 

G—7 

51443 

200 

243 

120 

G# —7 

54502 

212 

230 

121 

A—7 

57743 

225 

143 

122 

A# —7 

61176 

238 

248 

123 

B-7 

64814 

253 

46 
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<2 


- - 


*99 


24 
139 
1 26 
250 
6 
? 72 
243 
230 
143 
248 
46 




FILTER SETTINGS 


Location 

Contents 

54293 

Low cutoff frequency (0—7) 

54294 

High cutoff frequency (0—255) 

54295 

Resonance (bits 4 — 7) 

Filter voice 3 (bit 2) 

Filter voice 2 (bit 1) 

Filter voice 1 (bit 0) 

54296 

High pass (bit 6) 

Bandpass (bit 5) 

Low pass (bit 4) 

Volume (bits 0— 3 ) 
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APPENDIX 0 


SPRITE REGISTER MAP 


Register # 

Dec Hex 

DB7 

DB6 

DB5 

DB4 

DB3 

DB2 

DB1 

DB0 


0 

0 

S0X7 







soxo 

SPRITE 0 X 

Component 

1 

1 

S0Y7 







S0Y0 

SPRITE 0 Y 

Component 

2 

2 

S1X7 







S1X0 

SPRITE 1 X 

3 

3 

S1Y7 







SI YO 

SPRITE 1 Y 

4 

4 

S2X7 







S2X0 

SPRITE 2 X 

5 

5 

S2Y7 







S2Y0 

SPRITE 2 Y 

6 

6 

S3X7 







S3X0 

SPRITE 3 X 

7 

7 

S3Y7 







S3Y0 

SPRITE 3 Y 

8 

8 

S4X7 







S4X0 

SPRITE 4 X 

9 

9 

S4Y7 







S4Y0 

SPRITE 4 Y 

10 

A 

S5X7 







S5X0 

SPRITE 5 X 

11 

B 

S5Y7 







S5Y0 

SPRITE 5 Y 

12 

C 

S6X7 







S6X0 

SPRITE 6 X 

13 

D 

S6Y7 







S6Y0 

SPRITE 6 Y 

14 

E 

S7X7 







S7X0 

SPRITE 7 X 
Component 

15 

F 

S7Y7 







S7Y0 

SPRITE 7 Y 
Component 

16 

10 

S7X8 

S6X8 

S5X8 

S4X8 

S3X8 

S2X8 

S1X8 

S0X8 

MSB of X 

COORD. 

17 

11 

RC8 

ECM 

BMM 

BLNK 

RSEL 

YSCL2 

YSCL1 

YSCLO 

Y SCROLL 

MODE 

18 

12 

RC7 

RC6 

RC5 

RC4 

RC3 

RC2 

RC1 

RCO 

RASTER 

19 

13 

LPX7 







LPXO 

LIGHT PEN X 

20 

14 

LPY7 







LPYO 

LIGHT PEN Y 
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Register # 

Dec Hex 

DB7 

DB6 

DB5 

DB4 

DB3 

DB2 

DB1 

DBO 


21 

15 

SE7 







SEO 

SPRITE 

ENABLE 

(ON/OFF) 

22 

16 

N.C. 

N.C. 

RST 

MCM 

CSEL 

XSCL2 

XSCL1 

XSCLO 

X SCROLL 

MODE 

23 

17 

SEXY7 







SEXYO 

SPRITE 

EXPAND Y 

24 

18 

VS13 

VS12 

VS1 1 

VS10 

CB13 

CB12 

CB11 

N.C. 

SCREEN 

Character 

Memory 

25 

19 

IRQ 

N.C. 

N.C. 

N.C. 

LPIRQ 

ISSC 

ISBC 

RIRQ 

Interupt 

Request's 

26 

1A 

N.C. 

N.C. 

N.C. 

N.C. 

MLPI 

MISSC 

MISBC 

MRIRQ 

Interupt 

Request 

MASKS 

27 

IB 

BSP7 







BSPO 

Background- 

Sprite 

PRIORITY 

28 

1C 

SCM7 







SCMO 

MULTICOLOR 

SPRITE 

SELECT 

29 

ID 

SEXX7 







SEXXO 

SPRITE 

EXPAND X 

30 

IE 

SSC7 







SSCO 

Sprite-Sprite 

COLLISION 

31 

IF 

SBC7 







SBCO 

Sprite- 

Background 

COLLISION 
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DEC HEX COLOR 


■■ D0G 


5cC 

SPRITE 

ENABLE 

ON OFF) 


X SCROLL 

* - — 

‘.MODE 

5E*. V C 

SPRITE 

EXPAND Y 

\ Z- 

SCREEN 

Character 

Vemory 

5BC R 9Q 

'■terupt 

Request's 

ll58C v; 5Q 

1 "■'terupt 
Request 

MASKS 

8SP0 

Bqckground- 
j Sprite 

PRIORITY 

SC VO 

MULTICOLOR 

SPRITE 

SELECT 

ScXXO 

SPRITE 

EXPAND X 

ssco 

i Sprite-Sprite 
! COLLISION 

^8^ 

Sprite- 

Bqckground 

COLLISION 


COLOR CODES 


32 

20 

0 

0 

BLACK 

33 

21 

1 

1 

WHITE 

34 

22 

2 

2 

RED 

35 

23 

3 

3 

CYAN 

36 

24 

4 

4 

PURPLE 

37 

25 

15 

5 

GREEN 

38 

26 

6 

6 

BLUE 

39 

27 

7 

7 

YELLOW 

40 

28 

8 

8 

ORANGE 

41 

29 

9 

9 

BROWN 

42 

2A 

10 

A 

LT RED 

43 

2B 

11 

B 

GRAY 1 

44 

2C 

12 

C 

GRAY 2 

45 

2D 

13 

D 

LT GREEN 

46 

2E 

14 

E 

LT BLUE 



15 

F 

GRAY 3 


EXT 1 


BKGDO 


BKGD1 


BKGD2 


BKGD3 


SMC 0 


S3COL 


SMC 1 


SOCOL 


SI COL 


S2COL 


S4COL 


S5COL 


S6COL 


S7COL 


EXTERIOR COL 


SPRITE 

MULTICOLOR 0 


1 


SPRITE 0 COLOR 


LEGEND: 

CNLY COLORS 0-7 MAY BE USED IN MULTICOLOR CHARACTER MODE 
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APPENDIX P 


COMMODORE 64 SOUND CONTROL 
SETTINGS 


This handy table gives you the key numbers you need to use in your 
sound programs, according to which of the Commodore 64's 3 voices 
you want to use. To set or adjust a sound control in your BASIC pro¬ 
gram, just POKE the number from the second column, followed by a 
comma (,) and a number from the chart . . . like this: POKE 54276,17 

(Selects a Triangle Waveform for VOICE 1). 

Remember that you must set the VOLUME before you can generate 
sound. POKE54296 followed by a number from 0 to 15 sets the volume 
for all 3 voices. 

It takes 2 separate POKEs to generate each musical note ... for 
example POKE54273,34:POKE54272,75 designates low C in the sample 
scale below. 

Also . . . you aren't limited to the numbers shown in the tables. If 34 
doesn't sound "right" for a low C, try 35. To provide a higher SUSTAIN 
or ATTACK rate than those shown, add two or more SUSTAIN numbers 
together. (Examples: POKE54277,96 combines two attack rates (32 and 
64) for a combined higher attack rate . . . but . . . POKE54277,20 
provides a low attack rate (16) and a medium decay rate (4). 
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hhbbbhb 


SETTING VOLUME — SAME FOR ALL 3 VOICES 


VOLUME CONTROL 




SSjpM. from 0 (°W to 15 (loudest) 


POKE THIS 

NUMBER: 


VOICE NUMBER 1 


FOLLOWED BY ONE OF THESE NUMBERS 

° r • • ' 0 to *55 depending on range) 


TO PLAY A NOTE 

C 

at 

c# 

D 

D# 

E 

F 

F# 

G 

G# 

A 

A# 

B 

C 

C# 

H'GH frequency 

54273 34 

36 

38 

40 

43 

45 

48 

51 

54 

57 

61 

64 

68 

72 ! 

low frequency 

naeei 

54272 75 

UHHHH 

85 

126 

mam 

200 

52 

■m 

198 

127 

97 

111 

172 

126 

188 

149 

169 f[ 

waveform 

POKE 

triangle 

SAWTOOTH 

PULSE 

NOIS 

E 


9 J;.SE RATE tp,.l«, \ 

54276 

■■HUB 

hJ w m \ 

UUUObm 

33 

■■H 

65 

129 


A value of 0 to 15 (for Pulse waveform only) 
_A_value of 0 to 255 (for Pulse waveform onlvl 

mu 



T 0 PtAY A NOTE 


- GH FREQUENCY 
FREQUENCY 


54280 34 
54279 75 


* * vefoRm 


POKE 


C# 

D 

D# 

E 

F 

F# 

G 

G# 

A 

A# 

B 

36 

85 

■m 

38 

126 

■H 

40 

200 

43 

52 

45 

198 

48 

127 

51 

97 

54 

111 

57 

172 

61 

126 

64 

188 


68 

149 


72 

169 


54283 


17 


33 


129 



54282 

54281 


A value of 0 to 15 (for Pulse waveform only) 


ATTACK DECAY 

POKE 

ATK4 

ATK3 

ATK2 

ATK1 

DEC4 

DEC3 

DEC2 

DEC 1 


54284 

128 

■■■■ 

64 

32 

16 

8 

4 

2 

, 

SUSTAIN release 

POKE 

SUS4 

SUS3 

SUS2 

HUH 

SUSl 

HUH 

REL4 

1— 

REL3 

r REL2 

REL1 1 


54285 

128 

64 

32 

16 

8 

4 

2 

ri 
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VOICE NUMBER 3 






V V-SV 



TO PLAY A NOTE 

C 

C# 

D 

D# 

E 

F 

F# 

G 

G# 

A 

A# 

B 

C 

C# 


HIGH FREQUENCY 

54287 34 

36 

38 

40 

43 

45 

48 

51 

54 

57 

61 

64 

68 

72 


LOW FREQUENCY 

54286 75 

85 

126 

200 

52 

198 

127 

97 

111 

172 

126 

188 

149 

169 












WAVEFORM 

POKE 

TRIANGLE 

SAWTOOTH 

PULSE 

NOISE 

54290 

17 

33 

65 

129 


PULSE RATE 

HI PULSE 

LO PULSE 

54289 

54288 

A value of 0 to 255 (for Pulse waveform only) 








ATTACK/DECAY 

POKE 

ATK4 

ATK3 

ATK2 

ATK1 

DEC4 

DEC3 

DEC2 

DEC 1 


54291 

128 

64 

32 

16 

8 

4 

2 

1 

1 








BHIiHiBi 

mw 



SUSTAIN/RELEASE 

POKE 

54292 

SUS4 

128 

SUS3 

64 

SUS2 

32 

SUS1 

16 

REL4 

8 

REL3 

4 

REL2 

2 

REL1 

1 











TRY THESE SETTINGS TO SIMULATE DIFFERENT INSTRUMENTS 


Instrument 

Waveform 

Attack/Decay 

Sustain/Release 

Pulse Rate 

Piano 

Pulse 

9 

0 

Hi-0, Lo-255 

Flute 

Triange 

96 

0 

Not applicable 

Harpsichord 

Sawtooth 

9 

0 

Not applicable 

Xylophone 

Triangle 

9 

0 

Not applicable 

Organ 

Triangle 

0 

240 

Not applicable 

Colliape 

Triangle 

0 

240 

Not applicable 

Accordion 

Triangle 

102 

0 

Not applicable 

Trumpet 

Sawtooth 

96 

0 

Not applicable 


MEANINGS OF SOUND TERMS 

ADSR — Attack; Decay/Sustain/Release 

Attack — rate sound rises to peak volume 

Decay—rate sound falls from peak volume to Sustain level 

Sustain — prolong note at certain volume 

Release — rate at which volume falls from Sustain level 

Waveform — "shape" of sound wave 

Pulse — tone quality of Pulse Waveform 

NOTE: Attack/Decay and Sustain/Release settings should always be POKEd in your program 
BEFORE the Waveform is POKEd. 
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INDEX 

A 

Abbreviations, BASIC commands, 130, 

131 

Accessories, viii, 106-108 
Addition, 23, 26-27, 113 
AND operator, 1 1 4 
Animation, 43-44, 65-66, 69-75, 132, 
138-139 

Arithmetic, Operators, 23, 26-27, 
113-114 

Arithmetic, Formulas, 23, 26-27, 113, 
120, 140 
Arrays, 95-103 
ASC function, 128, 135-137 
ASCII character codes, 135-137 

B 

BASIC 

abbreviations, 130-131 
commands, 114-117 
numeric functions, 125-127 
operators, 113-114 
other functions, 1 29 
statements, 117-125 
string functions, 128 
variables, 112-113 
5 cKcgraphy, 156-158 
5 nary arithmetic, 75-77 
Bit, 75-76 
Business aids, 1 08 
Byte, 76 

C 

Cc culations, 22-29 
Ccssette tape recorder (audio), viii, 3, 
18-20, 21 

Ccssette tape recorder (video), 7 
Cassette, port 3 

C M R$ function, 36-37, 46-47, 53, 
55-60, 113, 128, 135-137, 148 
C^.R statement, 117 
CUR HOME key, 15 

Clock, 113 

CLOSE statement, 117 

aa jstment, 11-12 
C^RS codes, 58 
ceys 56-57 
-e-icry map, 64, 139 
? EEKS and POKES, 60-61 

screen and border, 60-63, 138 


Commands, BASIC, 114-117 
Commodore key, (see graphics keys) 
Connections 
optional, 6-7 
rear, 2-3 
side panel, 2 
TV/Monitor, 3-5 
CONT command, 114 
ConTRL key, 11, 16 
COSine function, 126 
CuRSoR keys, 10, 15 
Correcting errors, 34 
Cursor, 10 

D 

DATASSETTE recorder, (see cassette 
tape recorder) 

Data, loading and saving (disk), 18-21 
Data, loading and saving (tape), 
18-21 

DATA statement, 92-94, 118 
DEFine statement, 118 
Delay loop, 61, 65 
DELete key, 15 

DIMension statement, 118-119 
Division, 23, 26, 27, 113 
Duration, (see For . . . Next) 

E 

Editing programs, 15, 34 
END statement, 119 
Equal, not-equal-to, signs, 23, 26-27, 
114 

Equations, 114 

Error messages, 22-23, 150-151 
Expansion port, 141-142 
EXPonent function, 126 
Exponentiation, 25-27, 113 

F 

Files, (DATASSETTE), 21, 110-111 
Files, (disk), 21, 110-111 
FOR statement, 119 
FRE function, 129 
Functions, 125-129 

G 

Game controls and ports, 2-3, 141 

GET statement, 47-48, 119-120 

GET# statement, 120 

Getting started, 13-29 

GOSUB statement, 120 

GOTO (GO TO) statement, 32-34, 120 
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Graphic keys, 17, 56-57, 61, 132-137 
Graphic symbols, (see graphic keys) 
Greater than, 114 

H 

Hyperbolic functions, 140 

IEEE-488 Interface, 2-3, 141 
IF . . . THEN statement, 37-39, 120- 
121 

INPUT statement, 45-47, 121 

INPUT#, 121 

INSert key, 15 

INTeger function, 126 

Integer variable, 112 

I/O pinouts, 141-143 

I/O ports, 2-7, 141-143 

J 

Joysticks, 2-3, 141 

K 

Keyboard, 14-17 

L 

LEFT$ function, 128 

LENgth function, 128 

Less than, 114 

LET statement, 121 

LIST command, 33-34, 115 

LOAD command, 115 

LOADing programs on tape, 18-20 

LOGarithm function, 126 

Loops, 39-40, 43-45 

Lower case characters, 14-17 

M 

Mathematics 

formulas, 23-27 
function table, 140 
symbols, 24-27, 38, 114 
Memory expansion, 2-4, 142 
Memory maps, 62-65 
MID$ function, 128 
Modulator, RF, 4-7 
Multiplication, 24, 113 
Music, 79-90 

N 

Names 

program, 18-21 
variable, 34-37 
NEW command, 115 
NEXT statement, 121-122 


NOT operator, 114 
Numeric variables, 36-37 

O 

ON statement, 122 
OPEN statement, 122 
Operators 

arithmetic, 113 
logical, 114 
relational, 114 

P 

Parentheses, 28 

PEEK function, 60-62 

Peripherals, viii, 2-8, 107-109 

POKE statement, 60-61 

Ports, I/O, 2-3, 141-143 

POS function, 129 

PRINT statement, 23-29, 123-124 

PRINT#, 124 

Programs 

editing, 15, 34 
line numbering, 32-33 
loading/saving (DATASSETTE), 18-21 
loading/saving (disk), 18-21 
Prompt, 45 

Q 

Quotation marks, 22 

R 

RaNDom function, 48-53, 126 
Random numbers, 48-53 
READ statement, 124 
REMark statement, 124 
Reserved words, (see Command state¬ 
ments) 

Restore key, 15, 18 
RESTORE statement, 124 
Return key, 15, 18 
RETURN statement, 124 
RIGHT$ function, 128 
RUN command, 116 
RUN/STOP key, 16-17 

S 

SAVE command, 21, 116 

Saving programs (DATASSETTE), 21 

Saving programs (disk), 21 

Screen memory maps, 62-63, 138 

SGN, function, 127 

Shift key, 14-15, 17 

SINe function, 127 

Sound effects, 89-90 

SPC function, 129 
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*■ - 1: 1 ~ 


• :~-*09 


x -' a2 


23-25 * 23-124 



■5 r-~AS5ETTE 18-21 

c r s* *8-21 




S 3 R T E EDITOR, vii, 69-76 
'E graphics, vii, 69-76 
SQ~cRe function, 127 
STOP command, 125 
STOP key, 16-17 
String variables, 36-37, 112-113 
STRS function, 1 28 

Subscripted variables, 95-98, 112-113 
Subtraction, 24, 113 
Syntax error, 22 
SYS statement, 125 


TAB function, 1 29 
TAN function, 127 
Tl variable, 1 13 
TIS variable, 1 13 
Time clock, 1 13 
TV connections, 3-7 


U 

Upper Lower Case mode, 14 
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2 * 116 
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-cci 62-63, 138 

127 

17 

27 

19-90 

29 
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USR function, 127 

User defined function, (see DEF) 

V 

VALue function, 128 
Variables 

array, 95-103, 113 
dimensions, 98-103, 113 
floating point, 95-103, 113 
integer, 95-103, 112 
numeric, 95-103, 112 
string ($), 95-103, 112 
VERIFY command, 117 
Voice, 80-90, 162-164 

W 

WAIT command, 125 
Writing to tape, 1 10 

Z 

Z-80, vii, 108 










Commodore hopes you've enjoyed the COMMODORE 64 
USER'S GUIDE. Although this manual contains some pro¬ 
gramming information and tips, it is NOT intended to be a 
Programmer's Reference Manual. For those of you who are 
advanced programmers and computer hobbyists Commo¬ 
dore suggests that you consider purchasing the COMMO¬ 
DORE 64 PROGRAMMER'S REFERENCE GUIDE available 
through your local Commodore dealer. 
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In addition updates and corrections as well as programming hints and tips are available in 
the COMMODORE and POWER PLAY magazines, on the COMMODORE database of the 
COMPUSERVE INFORMATION NETWORK, accessed through a VICMODEM. 
























CO*m OOOftE 64 QUICK REFERENCE CARD 


«3E~X 


t z —r x 



-sec 


to 


SPC0O 

POS(X) 

O-R. HOME 

SHIFT CLR/HOME 

SHIFT INST, DEI 

INSTDEl 

CTRL 


CRSR Keys 


Commodore Key 


PRINTS X blanks on line 
Returns current cursor position 
Positions cursor to left corner of 
screen 

Clears screen and places cursor in 
"Home" position 
Inserts space at current cursor 
position 

Deletes character at current cursor 
position 

When used with numeric color key, 
selects text color. May be used in 
PRINT statement. 

Moves cursor up, down, left, right 
on screen 

When used with SHIFT selects 
between upper/lower case and 
graphic display mode. 

When used with numeric color key, 
selects optional text color 
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-noes s program from tope 
So*e-s n program on tape 
—o c a o progr»— from disk 
aomn o program- ^ drsi 

—.cr prog-o— *-as SA/Ed 


*AP» a 


S program 


rwr.nes pi-ogrom storting at iine 


5*C 

zzmvr 


*CKH * * 


Bos rwcrxjr 

Zzn —r .ms prog-am execution from 
r-e program was halted 

•rj—5 cpr-tert s of memory 
oc J x y X 

C*o-ges contern of location X 


sn ■» 


--mo* ts exec^e o machine languoge 
srsgrpr— Uonng art jocxxx 
s-ogrpm woe* until contents of 
-" : ‘ : -••• *•(> Z ond 

ftCec -i~ y s nonzero, 
fosses ^piv^e of X »o o mochine 

crijusje worsutne 


ANC KTtllMJGT'IMj COMMANDS 


JST 

isr m 


S e—re progrom 

» “x me A »o fine B 

* —esscge con be listed but 
i grerec O-ntg program execution 
sec r PRINT statements Spaces X 


ARRAYS AND STRINGS 

DIM A(X,Y,Z) 

Sets maximum subscripts for A; 
reserves space for (X+ 1)*(Y+ 1 )*(Z+ ' 
elements starting at A(0,0,0) 

LEN (XS) 

Returns number of characters in X$ 

STR$(X) 

Returns numeric value of X, 
converted to a string 

VAL(XS) 

Returns numeric value of AS, up to 
first nonnumeric character 

CHR$(X) 

Returns ASCII character whose code 
is X 

ASC(X$) 

Returns ASCII code for first 
character of X$ 

IEFTS(A$,X) 

Returns leftmost X characters of AS 

RIGHT$(A$,X) 

Returns rightmost X characters 
of AS 

MID$(A$.X,Y) 

Returns Y characters of A$ 
starting at character X 

INPUT OUTPUT COMMANDS 

INPUT AS OR A 

PRINTs '?' on screen and waits for 
user to enter a string or value 

INPUT "ABC";A 

PRINTs message and waits for user 
to enter value. Can also INPUT AS 

GET AS or A 

Waits for user to type one- 
character value; no RETURN needed 

DATA A,"B",C 

Initializes a set of values that 
can be used by READ statement 

READ AS or A 

Assigns next DATA value to AS or A 

RESTORE 

Resets data pointer to start 

READing the DATA list again 

PRINT "A= ";A 

PRINTs string 'A= ' and value of A 

V suppresses spaces - tabs data 
to next field. 

PROGRAM FLOW 

GOTO X 

Branches to line X 

IF A=3 THEN 10 

IF assertion is true THEN execute 
following part of statement. IF 
false, execute next line number 

FOR A= 1 TO 10 

Executes all statements between FOR 

STEP 2 : NEXT 

and corresponding NEXT, with A 
going from 1 to 10 by 2. Step size 
is 1 unless specified 

NEXT A 

Defines end of loop. A is optional 

GOSUB 2000 

Branches to subroutine starting at 
line 2000 

RETURN 

Marks end of subroutine. Returns to 
statement following most recent 
GOSUB 

ON X GOTO A,B 

Branches to Xth line number on 
list. If X = 1 branches to A, etc. 

ON X GOSUB A,B 

Branches to subroutine at Xth line 
number in list 










Get the most out of your Commodore computer with a subscription to 
Commodore s user magazines K 
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ABOUT THE COMMODORE 64 
USER'S GUIDE ... 


Outstanding color... sound synthesis ... graphics ... 
computing capabilities ... the synergistic marriage of 
state-of-the-art technologies. These features make the 
Commodore 64 the most advanced personal computer 
in its class. 

The Commodore 64 User's Guide helps you get started 
in computing, even if you’ve never used a computer 
before. Through clear, step-by-step instructions, you 
are given an insight into the BASIC language and how 
the Commodore 64 can be put to a myriad of uses. 

For those already familiar with microcomputers, the 
advanced programming sections and appendices 
explain the enhanced features of the Commodore 64 
and how to get the most of these expanded 
capabilities. 








